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Preface 



This publication provides the IBM system 
hardware and software support personnel 
with the information needed to analyze 
problems that may occur on the IBM Virtual 
Machine Facility/370 (VM/370) . 



HOW TBIS MANUAL IS ORGANIZED 



Use the directories and use the VM/3 70 
Data Areas an d Contr ol Block Logic to 
help you to isolate the problem. 

Dse the method of operation and program 
organization sections, if necessary, to 
understand the operation that was being 
performed. 



This manual comprises three volumes: 

"Volume 1. VM/370 Control Program (CP)," 
"Volume 2. Conversational Monitor System 
(CMS)," and "Volume 3. Remote Spooling 
Communications Subsystem (RSCS) " contain 
the logic description for each of the 
components. Each of these volumes is 
divided into four sections: Introduction, 
Method of Operation, Directory, and 
Diagnostic Aids. 

The method of operation and program 
organization sections contain the functions 
and relationships of the program routines 
in VM/370. They indicate the program 
operation and organization in a general way 
to serve as a guide in understanding 
VM/370. They are not meant to be a 
detailed analysis of VM/370 programming and 
cannot be used as such. 



DEVICE TERMINOLOGY 



The following terms in this publication 
refer to the indicated support devices: 

• "2305" refers to IBB 2305 Fixed Bead 
Storage, Models 1 and 2. 

• "270x" refers to IBM 2701, 2702, and 
2703 Transmission Control Units or the 
Integrated Communications Adapter (ICA) 
on the System/370 Model 135. 

• "3330" refers to the IBM 3330 Disk 
Storage, Models 1, 2, or 11; the IEH 
3333 Disk Storage and Control, Models 1 
or 11; and the 3350 Direct Access 
Storage operating in 3330/3333 Model 1 
or 3330/3333 Model 11 compatibility 
mode. 



The directories contain descriptions of 
all the assemble modules in CP, CMS, and 
RSCS, They also contain extensive 
cross-references between modules and labels 
within a VM/370 component. 

The diagnostic aids sections contain 
additional information useful for 
determining the cause of a problem. 

Appendix A, located in Volume 1, 
contains a description of VM/370 Extended 
Control-Program Support (ECPS) . 

I Appendix B, also located in Volume 1, 
I describes VM/370 support for the IBM 3850 
I Mass Storage System (HSS) . 



BOW TO USE THIS MANUAL 



Isolate the component of VM/370 in which 
the problem occurred. 

Use the list of restrictions in VM/370 
System Messages to be certain that the 
operation that was being performed was 
valid. 



• "3340" refers to the IBM 3340 Disk 
Storage, Models A2, B1, and B2, and the 
3344 Direct Access Storage Model B2. 

• "3350" refers to the IBM 3350 Direct 
lecess Storage Models A2 and B2 in 
native mode. 

• "3704", "3705", or "370X" refers to IEM 
3704 and 3705 Communications 
Controllers. 

• The term "3705" refers to the 3705 I and 
the 3705 II unless otherwise noted. 

• "2741" refers to the IBM 2741 and the 
3767, unless otherwise specified. 

• "3270" refers to a series of display 
devices, namely the IBM 3275, 3276, 
3277, 3278 Display Stations. A specific 
device type is used only when a 
distinction is required between device 
types. 

Information about display terminal usage 
also applies to the IBM 3036, 3138, 3148, 
and 3158 Display Consoles when used in 
display mode, unless otherwise noted. 



Preface iii 



Any information pertaining to the IBM 
3284 or 3286 also pertains to the IBM 3287, 
3288 ana the 3289 printers, unless 
otherwise noted. 



CP COMPONENT 



PREREQUISITE PUBLICATIONS 



Eat a Areas and Control Block Logic, 
Order No. SY20-0884 



In addition, for EREP processing the 
following OS/VS Library publications are 
required: 



OS/VS Environ mental Recording Editing and 
Printing (E RE P) Program , Order No. 
GC28-0772 



IBM Virtual Machine Facility/370 

Introduction. Order No. GC20-1800 

Operator's Guide. Order No. GC20-1806 

Svst.ei Programmer's Guide, Order No, 
GC20-1807 

Terminal Us e r^s Guide. Order No, 
GC20-1810 



CP Command Reference for General Users , 
Order No. GC20-1820 



COREQUISITE PUBLICATIONS 



IM Vir tual Machine Facility/370 



OS/VS Environmenta l Recording Editing and 
Printing ( EREP ) P rogram Logic, Order No. 
SY28-0773 



If the IBM 3850 Mass Storage System is 
attached, the following publications are 
required: 

O S/ VS Message Library : M ass Storag e System 
(Il§) Messages. Order No. GC38-1000 

IEH 385C Mass Stora ge System (MSS) 
Principles of Operation : Theory , Order No. 
GJ32-0035 

IEH 3850 Mass Stora ge System (MSS) 
Principles of Ope r at ion : Reference . Order 
No7~GA32-C036 



Plan ning and System Generation Guide. 
Order No. GC20-1801 



SUPPLEMENTARY PUBLICATIOHS 



System Messages. Order No. GC20-1808 

I BM System/360 Princi p les cf O per ation, 

OLTSEP and Error Recording Guid e. Order Order No. GA22-6821 

No. GC20-1809 

I EM System/370 Principles of Operation. 

Operating Systems in a Vir tual Mac hi ne, | Order No. GA22-7000 

Order No. GC20-1821 

I III? J270 Information Display System 

Servi ce Routines Program Logic. Order | Components Description , Crder No. GA27-2749 

No. SY20-0882 

I Ge neral Inform ation B i nary Synchron ous 
I Comm unications . Order No. GA27-3004 
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Sunary of Amendments 

for SY20-0886-1 

VH/370 Release 6 PLC 1 



3203 MODEL 5 PRIHTER SUPPORT 



Changed ; Documentation 



VH/370 supports the 3203 Model 5 printer 
in the same manner as the 3203 Model «t 
printer. 



SEARED SEGMENT MODIFICATIONS 



This support is added to VH/370 to 
prevent disclosure of virtual machine 
and minidisk passwords on the same line 
as the LOGON, AUTOLOG, and LINK 
commands. To reflect this support, the 
DIAGNOSE Code X*08' instruction has been 
updated. 

Changes are contained in the n CP 
Introduction" section of this 
publication. 



New; Program and Documentation 

VH/370 now places the user in console 
function mode if he modifies a protected 
shared segment; it returns the modified 
page to free storage. VM/370 continues 
to give other users of the segment 
access to a fresh copy of the modified 
page. This is discussed in the «CP" 
Introduction" section of this 
publication. 



The LOAD 
changed, 
finds the 
the named 
of page a 
for each 
each sha 
processor 
was define 



SYS diagnose function is 
ihen LOADSYS is executed, CP 
system name table entry for 
system. In AP mode, two sets 
nd swap tables are built, one 
processor. This is done for 
red segment in attached 
eode unless the named segment 
d as unprotected. 



New abend codes are also added. These 
are found in the "CP Diagnostic Aids" 
section of this publication. 



HESSAGE NO HEADER (HSGNOH) COHMAND SUPPORT 



New; Program and Documentation 

This support allows service virtual 
machines with privilege class B in a 
VM/370 system to send unformatted 
messages to other user of the system. 
The "CP Directories" section of this 
publication reflects the MSGNOH update. 



PASSWORD ON-THE-COHHAND-LINE SUPPRESSION 



New; Program and Documentation 



DI1GNOSE CODE X«08« INSTRUCTION ENHANCED 



Changed ; Documentation 

DIAGNOSE CODE X'OS 1 has been modified to 
allow the caller to choose to have 
information returned to his virtual 
machine's buffer or handled as console 
line output. This information is found 
in the "CP Introduction" section of this 
publication. 



LOGON, AUTOLOG AND LINK JOURNALING 



New: Program and Documentation 

VH/370 supports the journaling of LOGCN 
and AUTOLOG commands that specify 
invalid passwords, and the journaling of 
all LINK commands. This is done via the 
generation of type 04, 05, and 06 
accounting records. 

The "CP Directories" section of this 
publication has been updated to reflect 
this information. 



DIRECTORY 0PDATE IB-PLACE 



New: Program and Documentation 

The DIAGNOSE Code X'84» instruction is 
added to VH/370 to allow certain 
directory options to be changed on-line 
without updating the directory source 
file. 



Summary of Amendments ix 



This information is included in the "CP 
Introduction" and "CP Diagnostic Aids" 
sections of this publication. 



New Modules and their entry points have 
been added to the "Label-To-Hodule" and 
"Module-To-Label" cross references in 
this publication. 



VM/370 MEASUREMENT 
ENHANCEMENTS 



FACILITY (MONITOR) 



SPECIAL MESSAGE FACILITY 



New ; Program and Documentation 

The VM/370 Measurement Facility 
(Monitor) has been enhanced to extend 
its data collection and recording 
capabilities. These enhancements 
include: 

• The gathering of additional data 
related to utilization of channels, 
devices, storage, alternate 1/0 
paths, and AP/OP PROCESSING. 

• Selective seeks that allow system 
programmers to select devices for 
which seek information is to be 
collected. 

• Monitor-To-Disk support for real time 
allows system programmers to specify 
when the ¥M/370 Monitor is to close 
the spool file. 

A new subroutine, DHKENTTI, is added. 
It is a high-f reguency I/O status 
sampler that tests for busy conditions 
in all control units and devices by 
examining appropriate CP control blocks 
and in all channels via TCH 
instructions. 

A new subroutine, DMKENT62 samples the 
data accumulated by DHKENTTI and writes 
it in a new class 6 code 2 record, after 
the standard class 6 (DASTAP) code 1 
record has been collected in DMKMONTI. 

This information is contained in the "CP 
Directories" section of this 
publication. 



11331 AND 4341 PROCESSOR SUPPORT 



Hey : Documentation 

VM/370 provides support for the 4331 and 
4341 processors and the 3278 Model 2A 
display station as a system console for 
these processors. The character set on 
the 3278 Model 2A is the same as on the 
current 3270 display systems, plus six 
additional graphic national usage 
characters that are acceptable in input 
and output data streams. 



New: Program and Documentation 

A new CP command, SMSG, is provided to 
allow a terminal user to send a message 
to another user*s virtual storage. The 
receiving virtual machine must be 
prepared to receive the message. This 
is done by issuing a VMCF AUTHORIZE and 
setting SMSG ON prior to receiving a 
message. 

Information about Special Messages is 
found in the "CP Introduction" and "CP 
Directories" sections of this 
publication. 



IBM 3850 MASS STORAGE SYSTEM (MSS) SUPPOBT 



New: Program and Documentation 

Virtual machines operating CMS, 0S/VS1, 
or 0S/VS2 (HVS) can access mass storage 
volumes containing VB/370 minidisks or 
entire mass storage volumes dedicated to 
the virtual machine. These volumes will 
appear to the virtual machine as 3330 
volumes and will be accessed using 3330 
device support. CP controls unit 
allocation, volume mounting, and volume 
demounting. Virtual machines running 
0S/VS1 or 0S/VS2 (MVS) and that contain 
MSS support can also access mass storage 
volumes using dedicated device support. 

Communication with the Mass Storage 
Control (MSC) component of MSS is 
provided by service virtual machines 
operating either OS/VS1 or 0S/VS2 (MVS). 
The VM/370 control program initiates 
volume mounts and demounts via 
intersystem communication with an 
application program (DHKHSS) running 
under either 0S/VS1 or 0S/VS2 (MVS). 
For information about the logic of the 
DMKHSS application program, see the 
VM/370 Service Routi nes P rog ram Logic 
Manual, Order Number SY20-0882. 

DIAGNOSE Code ma* is added to 
communicate between a virtual machine 
and CP for MSS support. This 
information can be found in the "CP 
Introduction" section of this 
publication. 
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Appendix B is added to this publication 
to show flow diagrams of functions that 
utilize the HSS. 



3800 PRINTING SUBSYSTEM SUPPORT 



Hew ; Program and Documentation 

YM/370 supports the full facilites of 
the 3800 Printing Subsystem as a 
dedicated device. Limited 3800 printer 
support is provided by the VM/370 
spooling facility. 

DIAGNOSE Code X*74» is added to VM/370 
to save or load a named system that 
contains control tables and control 
modules for the 3800 printer. The new 
NAME3800 macro instruction allows named 
systems to be specified in the same 
manner as the NAMENP macro instruction. 
This information is contained in the "CP 
Introduction", "CP Directories", and "CP 
Method of Operation and Program 
Organization" sections of this 
publication. 



Two new utility programs, GENIHAGE and 
IMAGELIB construct or modify the tables 
and modules that control feature 
selections and printing on the 3800 
printer. The IMAGELIE utility saves the 
control tables and control modules as a 
named system. Logic details on GEHIMAGE 
and IMAGELIB are contained in the VM/370 
Service Ro utines Program Logic Manu al. 
Order Number SY20-0882. 



CP SBEND CODES REMOVED 



Chan ged : Documentation Only 

To eliminate duplication, the CP Abend 
codes have been removed from this 
manual. They are found in the VM/370 
System Message , Order Number GC20-1808. 



Summary of Amendments zi 



Summary of Amendments 

for SY20-0886-0 

as updated by TNL SN25-0467 

VM/370 Release 5 PLC 12 



VARY PROCESSOR ONLINE/OFFLINE SUPPORT 



Ngw and Changed; Programming Support 

VM/370 attached processor (AP) provides 
support to enhance the reliability, 
availability, and serviceability of the 
158 and 168 attached processors, and the 
158 and 168 asymmetric HP systems. 

This support allows the attached 
processor to be taken offline to make 
needed repairs, and then be brought back 
online without affecting the main 
processor. 
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Smeary of Amendments 

for SY20-0886-0 

as updated by TNL SH25-0446 

VH/370 Release 5 PLC 6 



3340/3344 ALTERNATE TRACK SUPPORT 



Changed: Program Support 

Software error recovery procedures now 
provide for switching to an alternate 
track when an attempt to do I/O on a 
defective 3340 or 3344 track results in 
a track condition check. Logic 
affecting CP I/O, Diagnose I/O, and SIO 
issued from a virtual machine is 
changed. These logic changes are 
reflected in this publication. 
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CP Introduction 



This part contains the following information: 

• YH/370 

• Program States 

• Using Processor Resources 

• Functional Information 

• Performance Guidelines 

• CP Interruption Handling 
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VM/370 



The VM/370 Control Program Manages the resources of a single computer in 
such a manner that multiple computing systems appear to exist. Each 
"virtual" computing system, or virtual machine, is the functional 
equivalent of an IBM System/370. 

A virtual machine is configured by recording appropriate information 
in the VM/370 directory. The virtual machine configuration includes 
counterparts of the components of a real IBM System/370: 

• A virtual operator* s console 

• Virtual storage 

• A virtual processor 

• Virtual I/O devices 

CP makes these components appear real to whichever operating system 
is controlling the work flow of the virtual machine. 

The virtual machines operate concurrently via multiprogramming 
techniques. CP overlaps the idle time of one virtual machine with 
execution in another. 

Each virtual machine is managed at two levels. The work to be done 
by the virtual machine is scheduled and controlled by some System/360 or 
System/370 operating system. The concurrent execution of multiple 
virtual machines is managed by the Control Program. 

VM/370 performs some functions differently when running in attached 
processor mode. For a description of the additional processing performed 
when in attached processor mode, see "The Attached Processor 
Environment" in this section. 



Introduction to the VM/370 Control Program 

A virtual machine is created for a user when he logs on VM/370, on the 
basis of information stored in his VH/370 directory entry. The entry 
for each user identification includes a list of the virtual input/output 
devices associated with the particular virtual machine. 

Additional information about the virtual machine is kept in the 
¥M/370 directory entry. Included are the VM/370 command privilege 
class, accounting data, normal and maximum virtual storage sizes, 
dispatching priority, and optional virtual machine characteristics such 
as extended control mode. 

The Control Program supervises the execution of virtual machines by 
(1) permitting only problem state execution except in its own routines, 
and (2) receiving control after all real computing system interrupts. 
CP intercepts each privileged instruction and simulates it if the 
current program status word of the issuing virtual machine indicates a 
virtual supervisor state; if the virtual machine is executing in 
virtual problem state, the attempt to execute the privileged instruction 
is reflected to the virtual machine as a program interrupt. All virtual 
machine interrupts (including those caused by attempting privileged 
instructions) are first handled by CP, and are reflected to the virtual 
machine if an analogous interrupt would have occurred on a real machine. 
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VIRTUAL MACHINE TIME MANAGEMENT 

The real processor simulates Multiple virtual processors. Virtual 
machines that are executing in a conversational manner are given access 
to the real processor more frequently than those that are not; these 
conversational machines are assigned the smaller of two possible time 
slices. CP determines execution characteristics of a virtual machine at 
the end of each time slice on the basis of the recent frequency of its 
console requests or terminal interrupts. The virtual machine is queued 
for subsequent processor utilization according to whether it is a 
conversational or nonconversational user of system resources. 

A virtual machine can gain control of the processor only if it is not 
waiting for some activity or resource. The virtual machine itself may 
enter a virtual wait state after an input/output operation has begun. 
The virtual machine cannot gain control of the real processor if it is 
waiting for a page of storage, if it is waiting for an input/output 
operation to be translated and started, or if it is waiting for a CP 
command to finish execution. 

A virtual machine can be assigned a priority of execution. Priority 
is a parameter affecting the execution of a particular virtual machine 
as compared with other virtual machines that have the same general 
execution characteristics. Priority is a parameter in the virtual 
machine's VM/370 directory entry. The system operator can reset the 
value with the privilege class A SET command. 



VIRTUAL MACHINE STORAGE MANAGEMENT 

The normal and maximum storage sizes of a virtual machine are defined as 
part of the virtual machine configuration in the VM/370 directory. You 
may redefine virtual storage size to any value that is a multiple of 4K 
and not greater than the maximum defined value. VM/370 implements this 
storage as virtual storage. The storage may appear as paged or unpaged 
to the virtual machine, depending upon whether or not the extended 
control mode option was specified for that virtual machine. This option 
is required if operating systems that control virtual storage, such as 
OS/VS1 or VM/370, are run in the virtual machine. 

Storage in the virtual machine is logically divided into 4096-byte 
areas called pages. A complete set of segment and page tables is used 
to describe the storage of each virtual machine. These tables are 
updated by CP and reflect the allocation of virtual storage pages to 
blocks of real storage. These page and segment tables allow virtual 
storage addressing in a System/370 machine. Storage in the real machine 
is logically and physically divided into 4096-byte areas called page 
frames. 

Only referenced virtual storage pages are kept in real storage, thus 
optimizing real storage utilization. Further, a page can be brought into 
any available page frame; the necessary relocation is done during 
program execution by a combination of VM/370 and dynamic address 
translation on the System/370. The active pages from all logged on 
virtual machines and from the pageable routines of CP compete for 
available page frames. When the number of page frames available for 
allocation falls below a threshold value, CP determines which virtual 
storage pages currently allocated to real storage are relatively 
inactive and initiates suitable page-out operations for them. 

Inactive pages are kept on a direct access storage device. If an 
inactive page has been changed at some time during virtual machine 
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execution, CP assigns it to a paging device, selecting the fastest such 
device with available space. If the page has not changed, it remains 
allocated in its original direct access location and is paged into real 
storage from there the next time the virtual machine references that 
page. A virtual machine program can use the DIAGNOSE instruction to 
tell CP that the information from specific pages of virtual storage is 
no longer needed; CP then releases the areas of the paging devices which 
were assigned to hold the specified pages. 

Paging is done on demand by CP. This means that a page of virtual 
storage is not read (paged) from the paging device to a real storage 
block until it is actually needed for virtual machine execution. CP 
makes no attempt to anticipate what pages might be required by a virtual 
machine. While a paging operation is performed for one virtual machine, 
another virtual machine can be executing. Any paging operation 
initiated by CP is transparent to the virtual machine. 

If the virtual machine is executing in extended control mode with 
translate on, then two additional sets of segment and page tables are 
kept. The virtual machine operating system is responsible for mapping 
the virtual storage created by it to the storage of the virtual machine . 
CP uses this set of tables in conjunction with the page and segment 
tables created for the virtual machine at logon time to build shadow 
page tables for the virtual machine. These shadow tables map the 
virtual storage created by the virtual machine operating system to the 
storage of the real computing system. The tables created by the virtual 
machine operating system may describe any page and segment size 
permissible in the IBH System/370. 



Storag e and Processor U tili z ati on 

The system operator may assign the reserved page frames option to a 
single virtual machine. This option, specified by the SET RESERVE 
command, assigns a specific amount of the storage of the real machine to 
the virtual machine. CP will dynamically build up a set of reserved 
real storage page frames for this virtual machine during its execution 
until the maximum number "reserved" is reached. Since the pages of 
other virtual machines are not allocated from this reserved set, the 
effect is that most of the active pages of the selected virtual machine 
remain in real storage. 

During CP system generation, the installation may specify an option 
called virtual=real. With this option, the virtual machine's storage is 
allocated directly from real storage at the time the virtual machine 
logs on (if it has the VIRT-REAL option in its directory) . All pages 
except page zero are allocated to the corresponding real storage 
locations. In order to control the real computing system, real page 
zero must be controlled by CP. Consequently, the real storage size must 
be large enough to accommodate the CP nucleus, the entire virtual-real 
virtual machine, and the remaining pageable storage requirements of CP 
and the other virtual machines. 

The virtual=real option improves performance in the selected virtual 
machine since it removes the need for CP paging operations for the 
selected virtual machine. The virtual-real option is necessary whenever 
programs that contain dynamically modified channel programs (excepting 
those of OS ISAH and OS/VS TCAH Level 5) are to execute under control of 
CP. For additional information on running systems with dynamically 
modified channel programs, see "Dynamically Modified Channel Programs" 
in VM/370 System Pro grammer's Guide. 
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YIRTOAL MACHINE I/O MANAGEMENT 

A real disk device can be shared among multiple virtual machines. 
Virtual device sharing is specified in the VM/370 directory entry or by 
a user command. If specified by the user, an appropriate password must 
be supplied before gaining access to the virtual device. A particular 
virtual machine may be assigned read-only or read/write access to a 
shared disk device. CP checks each virtual machine input/output 
operation against the parameters in the virtual machine configuration to 
ensure device integrity. 

Virtual Reserve/Release support can be used to further enhance device 
integrity for data on shared minidisks. Reserve/Release operation codes 
are simulated on a virtual basis for minidisks, including full-extent 
minidisks. For details on Reserve/Release support, refer to the topic 
"Reserve/Release," located under " Scheduling I/O Requests" in this 
section. 

The virtual machine operating system is responsible for the operation 
of all virtual devices associated with it. These virtual devices may be 
defined in the VM/370 directory entry of the virtual machine, or they 
may be attached to (or detached from) the virtual machine's 
configuration, dynamically, for the duration of the terminal session. 
Virtual devices may be dedicated, as when mapped to a fully equivalent 
real device; shared, as when mapped to a minidisk or when specified as a 
shared virtual device; or spooled by CP to intermediate direct access 
storage. 

In a real machine running under control of OS, input/output 
operations are normally initiated when a problem program requests OS to 
issue a START I/O instruction to a specific device. Device error 
recovery is handled by the operating system. In a virtual machine, OS 
can perform these same functions, but the device address specified and 
the storage locations referenced will both be virtual. It is the 
responsibility of CP to translate the virtual specifications to real. 

Virtual I/O can be initiated by either processor; however, all real 
I/O requests must be executed by the main processor, and all I/O 
interrupts must be received on the main processor (the processor with 
I/O capability) . Any I/O requests by the attached processor (the 
processor without I/O capability) are transferred to the main processor. 

In addition, the interrupts caused by the input/output operation are 
reflected to the virtual machine for its interpretation and processing. 
If input/output errors occur, CP records them but does not initiate 
error recovery operations. The virtual machine operating system must 
handle error recovery, but does not record the error (if SVC 76 is 
used) . 

Input/output operations initiated by CP for its own purposes (paging 
and spooling), are performed directly and are not subject to 
translation. 

| See Appendix B of this volume for an explanation of additional 
| processing when the virtual I/O request results in a real I/O request to 
| an MSS 3330V volume. 
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Dedicated Channels 

In nost cases, the I/O devices and control units on a channel are shared 
among many virtual machines as minidisks and dedicated devices, and 
shared with CP system functions such as paging and spooling. Because of 
this sharing, CP has to schedule all the I/O requests to achieve a 
balance between virtual machines. In addition, CP must reflect the 
results of the subsequent I/O interruption to the appropriate storage 
areas of each virtual machine. 

By specifying a dedicated channel (or channels) for a virtual machine 
via the Class B ATTACH CHANNEL command, the CP channel scheduling 
function is bypassed for that virtual machine. A virtual machine 
assigned a dedicated channel has that channel and all of its devices for 
its ovn exclusive use. CP translates the virtual storage locations 
specified in channel commands to real locations and performs any 
necessary paging operations, but does not perform any device address 
translations. The virtual device addresses on the dedicated channel 
must match the real device addresses; thus, a minidisk cannot be used. 

SPOOLING FUNCTIONS 

A virtual unit record device, which is mapped directly to a real unit 
record device, is said to be dedicated. The real device is then 
controlled completely by the virtual machine's operating system. 

CP facilities allow multiple virtual machines to share unit record 
devices. Since virtual machines controlled by CHS ordinarily have 
modest requirements for unit record input/output devices, such device 
sharing is advantageous, and it is the standard mode of system 
operation. 

Spooling operations cease if the direct access storage space assigned 
to spooling is exhausted, and the virtual unit record devices appear in 
a not-ready status. The system operator may make additional spooling 
space available by purging existing spool files or by assigning 
additional direct access storage space to the spooling function. 

Specific files can be transferred from the spooled card punch or 
printer of a virtual machine to the card reader of the same or another 
virtual machine. Files transferred between virtual unit record devices 
by the spooling routines are not physically punched or printed. With 
this method, files can be made available to multiple virtual machines, 
or to different operating systems executing at different times in the 
same virtual machine. 

CP spooling includes many desirable options for the virtual machine 
user and the real machine operator. These options include printing 
multiple copies of a single spool file, backspacing any number of 
printer pages, and defining spooling classes for the scheduling of real 
output. Each output spool file has, associated with it, a 136-byte area 
known as the spool file tag. The information contained in this area and 
its syntax are determined by the originator and receiver of the file. 
For example, whenever an output spool file is destined for transmission 
to a remote location via the Remote Spooling Communications Subsystem, 
RSCS expects to find the destination identification in the file tag. Tag 
data is set, changed, and queried using the CP TAG command. 
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It is possible to spool terminal input and output. All data sent to 
the terminal, whether it be from the virtual machine, the control 
program or the virtual machine operator, can be spooled. Spooling is 
particularly desirable when a virtual machine is run with its console 
disconnected. Console spooling is usually started via the command 

SPOOL CONSOLE START 

An exception to this is when a system operator logs on using a graphics 
device. In this instance, console spooling is automatically started and 
continues in effect even if the system operator should disconnect from 
the graphics device and log on to a nongraphic device. In order to stop 
automatic console spooling, the system operator must issue the command 

SPOOL CONSOLE STOP 



SPOOL FILE RECOVERY 

If the system should suffer an abnormal termination, there are three 
degrees of recovery for the system spool files; warm start (HARM), 
checkpoint start (CKPT) , and force start (FORCE). Warm start is 
automatically invoked if SET DUMP ADTO is in effect. Otherwise, the 
choice of recovery method is selected when the following message is 
issued; 

hh:mm:ss START ( (COLD |WARH| CKPT | FORCE) (DRAIN)) | (SHUTDOWN) : 

Note that a cold (COLD) start does not recover any spool files. 

Warm St art 

After a system failure, the warm start procedure copies spool file, 
accounting, and system message data to warm start cylinders on an 
auxiliary DASD. When the system is reloaded, this information is 
retrieved and the spool file chains and other system data are restored 
to their original status. If the warm start procedure cannot be 
implemented because certain reguired areas of storage are invalid, the 
operator is notified to take other recovery procedures. 



Checkp oint S tar t 

Any new or revised status of spool file blocks, spooling devices, and 
spool hold gueue blocks is dynamically copied to checkpoint cylinders on 
an auxiliary DASD as they occur. When a checkpoint (CKPT) start is 
reguested, this is the information that is used to recreate the spool 
file chains. It differs from warm start data in that only spool file 
data is restored; accounting and system messages information is not 
recovered. Also, the order of spool files on any particular restored 
chain is not the original seguence but a random one. 
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Force Start 

A force start is required when checkpoint start encounters I/O errors 
while reading files, or invalid data. The procedure is the saie as for 
checkpoint start except that unreadable or invalid files are bypassed. 



CP COMMANDS 

The CP commands allow you to control the virtual machine from the 
terminal, much as an operator controls a real machine. Virtual machine 
execution can be stopped at any time by use of the terminal's attention 
key (for 30 66 and 3270 terminals, the EHTER key is used) ; it can be 
restarted by entering the appropriate CP command. External, attention, 
and device ready interrupts can be simulated on the virtual machine. 
Virtual storage and virtual machine registers can be inspected and 
modified, as can status words such as the PSW and the CSff. Extensive 
trace facilities are provided for the virtual machine, as well as a 
single-instruction mode. Commands are available to invoke the spooling 
and disk sharing functions of CP. 

CP commands are classified by privilege classes. The VM/370 
directory entry for each user assigns one or more privilege classes. 
The classes are primary system operator (class A) , system resource 
operator (class B) , system programmer (class C) , spooling operator 
(class D) , system analyst (class E) , service representative (class F) , 
and general user (class G) . Commands in the system analyst class may be 
used to inspect real storage locations, but may not be used to make 
modifications to real storage. Commands in the operator class provide 
real resource control capabilities. System operator commands include 
all commands related to virtual machine performance options, such as 
assigning a set of reserved page frames to a selected virtual machine. 
For descriptions of all the CP commands, see the V M/370 CP Command 
Reference for General U sers and the VM/370 Operator *s Guide . 
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Program States 



When instructions in the Control Program are being executed, the real 
computer is in the supervisor state; at all other times, when running 
virtual machines, the real computer is in the problem state. Therefore, 
privileged instructions cannot be executed by the virtual machine. 
Programs running on a virtual machine can issue privileged instructions; 
but such an instruction either (1) causes an interruption that is 
handled by the Control Program, or (2) is intercepted and handled by the 
processor, if the virtual machine assist feature or VH/370 Extended 
Control-Program Support is enabled and supports that instruction. CP 
examines the operating status of the virtual machine PSW. If the 
virtual machine indicates that it is functioning in supervisor mode, the 
privileged instruction is simulated according to its type. If the 
virtual machine is in problem mode, the privileged interrupt is 
reflected to the virtual machine. 

Only the Control Program may operate in the supervisor state on the 
real machine. All programs other than CP operate in the problem state 
on the real machine. All user interrupts, including those caused by 
attempted privileged operations, are handled by either the control 
program or the processor (if the virtual machine assist feature or 
VH/370 Extended Control-Program Support is available) . Only those 
interrupts that the user program would expect from a real machine are 
reflected to it. A problem program will execute on the virtual machine 
in a manner identical to its execution on a real System/370 processor, 
as long as it does not violate the CP restrictions. See VH/370 System 
Messages for a list of the restrictions. 
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Using Processor Resources 



CP allocates the processor resource to virtual machines according to 
their operating characteristics, priority, and the system resources 
available. 

Virtual machines are dynamically categorized at the end of each time 
slice as interactive or noninteractive, depending upon the frequency of 
operations to or from either the virtual system console or a terminal 
controlled by the virtual machine. 

Virtual machines are dispatched from one of two queues, called Queue 
1 and Queue 2. In order to be dispatched from either queue, a virtual 
machine must be considered executable (that is, not waiting for some 
activity or for some other system resource) . Virtual machines are not 
considered dispatchable if the virtual machine: 

• Enters a virtual wait state after an I/O operation has begun. 

• Is waiting for a page frame of real storage. 

• Is waiting for an I/O operation to be translated by CP and started. 

• Is waiting for CP to simulate its privileged instructions. 

• Is waiting for a CP console function to be performed. 



Queue 1 

Virtual machines in Queue 1 (Q1) are considered conversational or 
interactive users, and enter this queue when an interrupt from a 
terminal is reflected to the virtual machine. Users are considered for 
dispatching from this queue on a first-in-first-out (FIFO) basis. When 
a virtual machine uses more than a certain amount of processor time 
without entering a virtual wait state, that user is placed in Queue 2. 

Virtual machines are dropped from Q1 when they complete their time 
slice of processor usage, and are placed in an "eligible list"* Virtual 
machines entering CP command mode are also dropped from Q1. When the 
virtual machine becomes executable again (returns to execution mode) it 
is placed at the bottom of Q1. 



Queue 2 

Virtual machines in Queue 2 (Q2) are considered noninteractive users. 
Users are selected to enter Q2 from a list of eligible virtual machines 
(the "eligible list"). The list of eligible virtual machines is sorted 
on a FIFO basis within user priority (normally defined in the user 
record in the VM/370 directory, but may be altered by the system 
operator) . 

Usually, a virtual machine is selected to enter Q2 only if its 
"working set" is not greater than the number of real page frames 
available for allocation at the time. The working set of a virtual 
machine is calculated and saved each time a user is dropped from Q2 and 
is based on the number of virtual pages referred to by the virtual 
machine during its stay in Q2, and the number of its virtual pages that 
are resident in real storage at the time it is dropped from the queue. 
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If the calculated working set of the highest priority virtual machine 
in the eligible list is greater than the number of page frames available 
for allocation, then 75 percent of the working set for that virtual 
■achine is calculated. If the pages required for 75 percent of the 
working set are available, the virtual Machine is placed on Q2. 
Otherwise, the virtual Machine remains on the eligible list until there 
are no other users on Q1 or Q2. 

Executable virtual Machines are sorted by "dispatching priority". 
This priority is calculated each time a user is dropped from a queue and 
is the ratio of processor tiMe used while in the queue to elapsed time 
in the queue. Infrequent processor users are placed at the top of the 
list and are followed by more frequent processor users. When a 
nonexecutable user becomes executable, he is placed on the queue based 
on his dispatching priority. 

When a virtual Machine coMpletes its tiMe slice of processor usage, 
it is dropped froM Q2 and placed in the eligible list by user priority. 
When a user request in Q2 enters CP command mode, it is removed from Q2. 






execution mode) , it is placed in the eligible list based on user 
priority. 

If a user's virtual machine is not in Q1 or Q2, it is because: 

• The virtual machine is on the "eligible list," waiting to be put on 
Q2 

— or — 

• The virtual machine execution is suspended because the user is in CP 
mode executing CP commands 

To leave CP mode and return his virtual machine to the "eligible 
list" for Q2, the user can issue one of the CP commands that transfer 
control to the virtual machine operating system for execution (for 
example, BEGIN, IPL, EXTERNAL, and RESTART) . 

In CP, interactive users (Q1) , if any, are considered for dispatching 
before noninteractive users (Q2) . This means that CHS users entering 
commands that do not involve disk or tape I/O operations should get fast 
responses from the VM/370 system even with a large number of active 
users. 

An installation may choose to override the CP scheduling and 
dispatching scheme and force allocation of the processor resource to a 
specified user, regardless of its priority or operating characteristics. 
The favored execution facility allows an installation to: 

1. Specify that one particular virtual machine is to receive up to a 
specified percentage of processor time. 

2. Specify that any number of virtual machines are to remain in the 
queues at all times. Assignment of the favored execution option is 
discussed in the "Preferred Virtual Machines" section. 
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Functional Information 



The functional diagrams that follow describe the program logic 
associated with various control program functions. Hot all CP functions 
are described. These functional diagrams are meant to describe the CP 
functions about which you may want more detailed information if you are 
debugging, modifying, or updating CP. 

Figure 1 describes CP initialization process. 

Figures 2 and 3 describe the real and virtual I/O control blocks used 
by CP in its I/O control. 

Figures 4, 5, and 6 show how CP handles SVC, external, and program 
interrupts. 

The CP paging function is described in Figure 7. 

The CP spooling function (both virtual and real) is described in 
Figures 8 and 9. 

Figure 10 shows how virtual tracing is performed. 

Figure 11 shows the steps involved in translating a virtual address 
to a real address and gives an example of address translation. 

The functional information contained in these diagrams is intended 
for system programmers and IBM Field Engineering program support 
representatives . 
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The real machine configuration is represented by 
a set of related control blocks. These blocks are: 

• in the VM/370 nucleus 

• built from macros during system generation 

• loaded at system IPL and initialized then for 
operation. 

There is one control block per channel, per control 

unit, and per device. 

The characteristics of VM/370 real I/O control are: 

• Block multiplexing (BMPX) with RPS (Rotational Position 
Sensing) is used. 

• Multi-path scheduling is not used. 

• All I/O operations are handled by VM/370 
scheduling and interrupt handling. 




negative value (FFFF) 
indicates that no channel exists 
positive value is an index 
to the RCHBLOK 



■ Relationship of Real I/O Control Blocks • 
DMKRIOCT (part of DMKRIO) 



RCHBLOK - real channel block 1 
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RCUBLOK - real control unit block 




Control Unit identification 
Scheduling Control 
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if negative (FFFF), no control 

unit exists 
if positive, that value is an 

index to the RCUBLOK 




Device 
Index 
Table 



IRDEVBLOK - real device block 1 



if negative (FFFF), no 

device exists 
if positive, that value is 

an index to RDEVBLOK 



Device identification 
Scheduling Control 
Terminal Control 
Spooling Control 
Dedicated Control 
Error Recovery 
Allocation Control 



For a complete tiatcrlption of CP control blocks, tee IBM Virtual Machine Facility/370: Data Areas and 
Control Blocks, 0rd«r No. SY204684. 



Part of the RDEVBLOK pertains to functions that are 
device independent; that part of the RDEVBLOK is used 
in the same way for all devices. However, some of the . 
fields in the RDEVBLOK have multiple uses, depending 
on the device type and function. 
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The virtual machine configuration is represented by a set 
of related control blocks. These blocks are: 

• built by VM/370 at LOGON from data in directory 

• modified by user commands (for example, DETACH, LINK, DEFINE 
There is one control block per channel, per control unit, and per 
device. 

The characteristics of VM/370 virtual I/O control are: 

• BMPX (block multiplexing) is supported 

• RPS (rotational position sensing) is supported 

• the virtual machine operating system performs scheduling 

• VM/370 uses virtual I/O control blocks to 
simulate real hardware interface 

• virtual unit record devices use VM/370 Spooling 

• virtual console is simulated on terminal 

• minidisks simulate DASD 

• dedicated devices are supported 



VMCHTBL — virtual channel index table 



■ Relationship of Virtual I/O Control Blocks 
VMCHTBL (part of VMBLOK) 




VCHBLOK - virtual channel block 



VCUBLOK - virtual control unit block 



VDEVBLOK - virtual device block' 



Channel identification 
status 


xxxx 


xxxx 


xxxx 


xxxx 


xxxx 


xxxx 


xxxx 


xxxx 












Control unit identification 
status 


xxxx 


xxxx 


xxxx 


xxxx 


xxxx 








xxxx 


/ 







Device 
Index 
Table 



if negative (FFFF), no control 

unit exists 
if positive, the value is an index 

to the VCUBLOK 




Device identification 
Status pending 
Positioning 
Terminal control 
Spooling control 



RDEVBLOK Pointer 



if negative (FFFF), no device 

exists 
if positive, the value is an index 

to the VDEVBLOK 



Part of the VDEVBLOK contains device independent 
information and is used identically in all VDEVBLOKs. 
However, some fields of the VDEVBLOKs have multiple 
uses, depending on the device type. 



For a detailed description of the CP control blocks, see IBM Virtual Machine 
Facility /370: Data Areas and Control Blocks. Order No. SY20-0884. 
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SVC Interrupt 



■INPUT- 
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GR 1 GR 2 




? 



- Process- 



es 

H 

p 
n- 
H 
O 
P» 



o 

rt* 
H« 
O 

P 



I 

-A 



> 




If PROBLEM MODE 

• And ADSTOP SVC, simulate 'ADSTOP' to 
virtual machine 

• And an SVC 76, verify the parameters and 
call DMKVER to build the error record. ^H 

• And virtual machine is in extended ^B 
mode and/or Page is not in storage, 
reflect interrupt to virtual machine 

• Otherwise, fetch Page 0, move CP PSW 

to virtual SVCOPSW, and move SVCNPSW 
to the CP PSW 

• If supervisor mode, run user-LPSW 

If SVC (Impossible condition or fatal error), 
dump the machine 



If SVC 8 (Link Request), ^M 

pass control from one module to another 



If SVC 12 (Return Request), 

return control to calling module 



i — OUTPUT- 



> 



VMBLOK User 




(dump) 



If SVC 16, release Save Area 



e 



If SVC 20, get next save area for 
calling module 



If SVC 24, switch processing to 
main processor 



o 




SAVE AREA OF 
MODULE CALLED 



SAVE AREA OF CALLING 
MODULE 



If DMKSVC determines that the SVC 76 
parameters are valid, it calls DMKVER to build the 
error record. If the parameters are not valid or if 
DMKVER cannot build the error record, DMKSVC 
reflects the SVC back to the virtual machine. If the 
error record is recorded, DMKVER gives control to 
the dispatcher with the user's running status set to 
return to the next sequential instruction following 
the SVC 76. 



A new save area is acquired 
and passed on. The caller's addressability 
register (R 12), the save area address (R 13), 
and the return address (SVCOPSW) are 
saved in the new save area. 



Control is returned to module issuing 
SVC 16, rather than to calling module 
as in SVC 12. 

Return is to module issuing SVC 20. 



Return is on other processor to 
module issuing SVC 24. 
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External Interrupt 



■INPUT- 



PSA (Prefix Storage Area) 




Process ■ 




If TOD clock comparator interrupt 

• unchain from TOD clock comparator 

• queue the related TRQBLOK 

• place on dispatch queue 

• set new clock comparator request B 



RDEVBLOK (for 

operator) 



If CPU timer interrupt 

• flag running user to be dropped from queue 

If a Timer interrupt 

• if supervisor mode, ignore Timer interrupt 

> 



, • otherwise, save machine status 



GOTO 
DISPATCH E 



D 



■OUTPUT- 



0> 



IE 



1 




If interrupt from the Console Interrupt Button (External) 

• Set the disconnect flag in VMBLOK 
~^> • Halt any outstanding I/O 

• Clear any outstanding console requests 
~\^> • If the running user was not interrupted, 

resume where left off by LPSW of External old PSW 

• Otherwise 







VMGPRS 








VMFPRS 








VMPSW 




VMOSTAT 










VMBLOK 




VMOSTAT 




X'10' 




VMTERM 




X'00' 







("goto "N 

DISPATCHER J 



External interrupt from control panel is used to disconnect 
the system operator's terminal. The system operator may 
reconnect at any other terminal via the LOGON command. 
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Program Interrupt 




■ Process ■ 



J> Determine machine mode and cause of interrupt 



If in supervisor mode, go to DMKDMPDK to take CP dump ' 



If invalid operation, go to DMKPRGRF routine I 



~J} If recognizable privileged instruction, 

simulate it 




< 



GOTO 
DMKPRGRF 



J> 



If privileged instruction is not recognized, ^j| 
issue SVC and dump CP 



s> 



TC> 



If paging exception, call DMKPTRAN to 
bring page with requested address 
into real storage. 



If program interrupt occurs in virtual 
problem mode, reflect the 
interrupt back to the virtual 
machine 



r\i i-rni it 










VMBLOK 




Virtual Storage 














VMPSW 




VMINST 


















SWPTABLE 









This is the entry point 
to reflect SVC interrupts 
(when DMKSVC could not 
reflect it) and to reflect 
privileged instructions that 
cannot be simulated by 
DMKPRVLG 



| Invalid operation code 

is in GRO. The VMINST 
field of the VMBLOK contains 
the image of the privileged 
instruction that caused the 
interrupt 
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VMBLOK 




User's Page 














VMPSW 


VMINST 
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r— INPUT- 



Request For 
Real Storage 



GR2 REQUEST GPR1 



Virtual Address 




PAGCORE 

real page 
address 



C> 



■INPUT 




PAGING 
DEVICE 



T 



■ PROCESS - 



Translate addn 



Is requested page already in storage?! 



Determine page selection 



•OUTPUT- 







1 
NO 


FREELIST 


FLUSHLIST 
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Release pages 






Allocate OASD space 






Schedule page I/O 






Mark page free 
1 



PAGING 
DEVICE 



^> 



r 



Lock — if requested 
Form address 
Return to requester 



GR 2 Real Address 



^B Bits defined for CORFLAG 


^A Bits defined for SWPFLAG 


CORIOLCK 


EQU 


XW 


Page locked for I/O 


SWPTRANS 


EQU 


XW 


Page in transit 


CORCFLCK 


EQU 


X'40' 


Page locked by console function 


SWPRECMP 


EQU 


X'40' 


Page permanently assigned 


CORFLUSH 


EQU 


X'20' 


Page is in flush list 


SWPALLOC 


EQU 


X'20' 


Page enqueued for allocation 


CORFREE 


EQU 


X'10' 


Page is in free list 


SWPSHR 


EQU 


X'10' 


Page shared 


CORSHARE 


EQU 


X'08' 


Page is shared 


SWPREF1 


EQU 


X'08' 


1st half page referenced 


CORRSV 


EQU 


X'04' 


Page is reserved 


SWPCHG1 


EQU 


X'04' 


1st half page changed 


CORDISA 


EQU 


X"01' 


Page disabled — not available 


SWPREF2 


EQU 


X'02' 


2nd half page referenced 




SWPCHG2 


EQU 


x'or 


2nd half page changed 
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SIO From Virtual 
Machine 



■ INPUT- 
GR2 




Virtual Storage 
VDEVBLOK 
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VDEVSPL 



VDEVCSW 



I DMKVSP 



> 



.PROCESS. 



If spool file not open, 

create VSPLCTL 
get virtual buffer 
save data in VSPLCTL 



If Printer, Punch, or Console ^^B 
get a work buffer ^^ 
get virtual CCW 
move logical record (CCW and data) from 

spool buffer to work buffer 
move data to user's data area 
post 'interrupt' pending and return to virtual machine | 

If a Card Reader 

get a work buffer 

get virtual CCW 

move logical record (CCW and data) from 

spool buffer to work buffer 
move data to virtual data area 
post 'interrupt' pending and return to virtual machine. 



Virtual console spooling is the same as printer spooling except that: 

• A skip to channel one CCW is inserted every 60 lines of output 

• The operator's virtual console spool buffer is written for every 16 lines of output 

• The Virtual spool buffer is written to the allocated spool device when the first CCW is 
placed in the Virtual buffer. The buffer is kept in a pseudo closed state so that checkpoint 
saves the buffer in the event of a system failure. 
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OUTPUT 

Real Storage 












Free 

Storage 

Area 




VSPLCTL 




WORK 
BUFFER 










/*• 


SPLINK 




Read CCW 














TIC 












Dynamic 
Paging 


Data 


Read CCW 


\ 7 Storage 


TIC 


User's virtual machine 

page containing the Data Area 




Data 
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SPOOL BUFFER 
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■INPUT FOR PUNCH/PRINTER 
RDEVBLOK 



Interrupt From 
Spool Device 




— OUTPUT FOR PUNCH/PRINTER 




CCWs Jtic 



CCWs [TIC 



=> 
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L^ 



-OUTPUT FOR READER - 



Real Storage 



DASD Auxiliary Storage 
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Entered From DMKCFM 
After TRACE' Command 
Entered 



■ INPUT- 



TRACE XXX 



A 



DMKTRA 



> 



PROCESS 



Pick up operands and options and check for validity 

If 'OFF' specified, turn off flags 

If 'END' specified, call 

DMKTRCPB to restore any instructions 
altered by TRACE, turn off flags, and 
return TREXT block to free storage 

Otherwise, 

Issue TRACE STARTED' message 
Get trace control block arid set VMBLOK 
pointer to it, if a trace control block does 
not exist. Set trace flags. Call DMKTRCIT to 
initialize branch or full instruction tracing 
if specified. 



Entry via SVC 8 



rt 
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-PROCESS 






— uu i ru i 
VMBLOK 












■ nts\ I 




n equal ' 






VMTREXT 


TREXCTL1 




TREXCTL2 


VMTRCTL 


TREXTERM 




TREXPRNT 






TREXRUNF 

















COMMENTS 



Put trace prefix and type in output line 
Convert binary addresses to hexadecimal (DMKCVT) 
Get mnemonic for OP code, if applicable (DMKNEM) 
Write trace line to output device 

If ATTN was pressed or if halt after trace line was specified 
enter console function mode and exit 



ADSTOP ADDRESS 




If this turns off the last flag, then the TREXT block 
is returned to free storage. If branch and instruction 
tracing are both turned off, DMKTRCPB is called 
to put back any instructions altered by TRACE. 



VMTRCTL and TREXCTL1 are identical. 



e 



Entry via SVC 8 as follows 

Entry Point 



From 



External Interrupt DMKTRCEX 

I/O Interrupt DMKTRCIO 

Program Interrupt DMKTRCPG 

Privileged Instructions DMKTRCPV 

I/O Operations DMKTRDSI 

Virtual and Real CSWs DMKTRCSW 

SVC, branch or full DMKTRCSV 

instruction trace 
Restore user instructions 

altered by tracing 

Initialize instruction tracing DMKTRCIT 



DMKDSP 

DMKDSP 

DMKPRG 

DMKPRV 

DMKVIOEX 

DMKVIOIN 

DMKPSA 



DMKTRCPB DMKTRA 



If 'OFF'specified, restore instruction and free work buffer 
Otherwise, 

Get work buffer 

Set VMBLOK pointer 

Save instruction and its virtual address 

Replace instruction with SVC B3 
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Virtual Address 



Segment Page 



7 8 \ 16 \19 20 



LOCATE THE 
SEGMENT TABLE 



Segment Table Register (CR1) 



USE AS 

INDEX TO SEGMENT 

TABLE ENTRY 



m 





USE AS INDEX 
TO PAGE TABLE 
ENTRY 



Block 
Number 


Displacement 



• Example ■ 



Translate Virtual Addres' 0008D424 to Real Address 



Virtual Address 




















F0014440 

















B Locate the appropriate Segment Table 
entry - The eighth entry in 
the Segment Table at location 014440 
This entry points to the Page Table. 

Locate the appropriate Page Table entry 

The 13 th entry in the Page Table at 

location 014440. This entry contains 

the real block number. / Block 

/ Number 

BThe block number in the Page / 
Table entry and the displacement in 
the Virtual Address combine to provide the Real Address 




012 


424 



: Real Address 



Displacement 



Real Address 



Performance Guidelines 



General Information 

The performance characteristics of an operating system, vhen it is run 
in a virtual machine environment, are difficult to predict. This 
unpredictability is a result of several factors: 

• The System/370 model used. 

• The total number of virtual machines executing. 

• The type of work being done by each virtual machine. 

• The speed, capacity, and number of the paging devices. 

• The amount of real storage available. 

• The degree of channel and control unit contention, as veil as arm 
contention, affecting the paging device. 

• The type and number of VM/370 performance options in use by one or 
more virtual machines. 

j • The degree of access to MSS 3330V volume. 

Performance of any virtual machine may be improved up to some limit 
by the choice of hardware, operating system, and VH/370 options. The 
topics discussed in this section address: 

1. The performance options available in VH/370 to improve the 
performance of a particular virtual machine. 

2. The system options and operational characteristics of operating 
systems running in virtual machines that will affect their 
execution in the virtual machine environment. 

The performance of a specific virtual machine may never egual that of 
the same operating system running standalone on the same System/370, but 
the total throughput obtained in the virtual machine environment may 
egual or better that obtained on a real machine. 

When executing in a virtual machine, any function that cannot be 
performed wholly by the hardware causes some degree of degradation in 
the virtual machine's performance. As the control program for the real 
machine, CP initially processes all real interrupts. A virtual machine 
operating system's instructions are always executed in problem state. 
Any privileged instruction issued by the virtual machine causes a real 
privileged instruction exception interruption. The amount of work to be 
done by CP to analyze and handle a virtual machine-initiated interrupt 
depends upon the type and complexity of the interrupt. 

The simulation effort required of CP may be trivial, as for a 
supervisor call (SVC) interrupt (which is generally reflected back to 
the virtual machine) , or may be more complex, as in the case of a Start 
I/O (SIO) interrupt, which initiates extensive CP processing. 

When planning for the virtual machine environment, consideration 
should be given to the number and type of privileged instructions to be 
executed by the virtual machines. Any reduction in the number of 
privileged instructions issued by the virtual machine's operating system 
will reduce the amount of extra work CP must do to support the machine. 
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Virtual Machine I/O 

To support I/O processing in a virtual machine, CP must translate all 
virtual machine channel command word (CCW) sequences to refer to real 
storage and real devices and, in the case of minidisks, real cylinders. 
When a virtual machine issues an SIO, CP must: 

1. Intercept the virtual machine SIO interrupt. 

2- Allocate real storage space to hold the real CCW list to be 
created. 

3. Translate the virtual device addresses referred to in the virtual 
CCWs to real addresses. 

4. Page into real storage and lock, for the duration of the I/O 
operation, all virtual storage pages required to support the I/O 
operation. 

5. Generate a new CCW sequence building a Channel Indirect Data 
Address list if the real storage locations cross page boundaries. 

6. Schedule the I/O request. 

7. Present the SIO condition code to the virtual machine. 

8. Intercept, retranslate, and present the channel end and device end 
interrupts to the appropriate virtual machine, where they must then 
be processed by the virtual machine operating system. 

CP*s handling of SIOs for virtual machines can be one of the most 
significant causes of reduced performance in virtual machines. 

The number of SIO operations required by a virtual machine can be 
significantly reduced in several ways: 

• Dse of large blocking factors (of up to 4096 bytes) for user data 
sets to reduce the total number of SIOs needed. 

• Use of preallocated data sets. 

• Use of virtual machine operating system options (such as chained 
scheduling in OS) that reduce the number of SIO instructions. 

• Substitution of a faster resource (virtual storage) for I/O 
operations, by building small temporary data sets in virtual storage 
rather than using an I/O device. 

Frequently, there can be a performance gain when CP paging is 
substituted for virtual machine I/O operations. The performance of an 
operating system such as OS can be improved by specifying as resident as 
many frequently used OS functions (transient subroutines, ISAH indexes, 
and so forth) as are possible. In this way, paging I/O is substituted 
for virtual machine- initiated I/O. In this case, the only work to be 
done by CP is to place into real storage the page that contains the 
desired routine or data. 



1-26 IBM VM/370 System Logic and Problem Determination — Volume 1 



Three CP performance options are available to reduce the CP overhead 
associated with virtual machine I/O instructions or other privileged 
instructions used by the virtual machine's I/O Supervisor; 

1. The virtual^real option removes the need for CP to perform storage 
reference translation and paging before each I/O operation for a 
specific virtual machine. 

2. The virtual machine assist reduces the real supervisor state time 
used by VM/370. See VM/ 370 Planning a nd System Generation Guide 
for a list of the processors on which it is available. 

3. VM/370 Extended Control-Program Support further reduces the real 
supervisor state time used by YM/370. See VH/370 Planning and 
Sy stem Generation Guide for a list of the processors on which it is 
available. 



Assignment and use of these options is discussed in "Preferred 
Virtual Machines." 



Paging Considerations 

When virtual machines refer to virtual storage addresses that are not 
currently in real storage, they cause a paging exception and the 
associated CP paging activity. 

The addressing characteristics of programs executing in virtual 
storage have a significant effect on the number of page exceptions 
experienced by that virtual machine. Routines that have widely 
scattered storage reference tend to increase the paging load of a 
particular virtual machine. When possible, modules of code that are 
dependent upon each other should be located in the same page. Reference 
tables, constants, and literals should also be located near the routines 
that use them. Exception or error routines that are infrequently used 
should not be placed within main routines, but located elsewhere. 

When an available page of virtual storage contains only reenterable 
code, paging activity can be reduced, since the page, although referred 
to, is never changed, and thus does not cause a write operation to the 
paging device. The first copy of that page is written on the paging 
device when that frame is needed for some other more active page. Only 
inactive pages that have changed must be paged out. 

Virtual machines that reduce their paging activity by controlling 
their use of addressable space improve resource management for that 
virtual machine, the VM/370 system, and all other virtual machines. The 
total paging load that must be handled by CP is reduced, and more time 
is available for productive virtual machine use. 

Additional dynamic paging storage may be gained by controlling free 
storage allocation. The amount of free storage allocated at VM/370 
initialization time can be controlled by the installation. When the 
System is being generated, the FREE operand of the SYSCOR macro 
statement may be used to specify the number of free storage pages to be 
allocated at system load time. 

If, at IPL time, the amount of storage that these pages represent is 
greater than 25 percent of the VM/370 storage size (not including the 
V=R area, if any), a default number of pages is used. The default value 
is 3 pages for the first 256K bytes of storage plus 1 page for each 
additional 6UK bytes (not including the V=R size, if any) . 
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The SYSCOR lacro definition can be found in V M/370 Planning and 
Sy stem Generation Guide. 

CP provides three performance options, locked pages, reserved page 
frames, and a virtual=real area, to reduce the paging requirements of 
virtual machines. Generally, these facilities reguire some dedication 
of real storage to the chosen virtual machine and, therefore, improve 
its performance at the expense of other virtual machines. 



LOCKED PAGES OPTION 

The LOCK command, which is available to the system operator (with 
privilege class A), can be used to permanently fix or lock specific user 
pages of virtual storage into real storage. In so doing, all paging I/O 
for these page frames is eliminated. 

Since this facility reduces total real storage roso'irces (real page 
frames) that are available to support other virtual machines, only 
frequently used pages should be locked into real storage. Since page 
zero (the first 4096 bytes) of a virtual machine storage is referred to 
and changed frequently (for example, whenever a virtual machine 
interrupt occurs or when a CSW is stored) , it should be the first page 
of a particular virtual machine that an installation considers locking. 
The virtual machine interrupt handler pages might also be considered 
good candidates for locking. 

Other pages to be locked depend upon the work being done by the 
particular virtual machine and its usage of virtual storage. 

The normal CP paging mechanism selects unreferenced page frames in 
real storage for replacement by active pages. Page frames belonging to 
inactive virtual machines will all eventually be selected and paged out 
if the real storage frames are needed to support active virtual machine 
pages. 

When virtual machine activity is initiated on an infrequent or 
irregular basis, such as from a remote terminal in a teleprocessing 
inquiry system, some or all of its virtual storage may have been paged 
out before the time the virtual machine must begin processing. Some 
pages will then have to be paged in so that the virtual machine can 
respond to the teleprocessing request compared with running the same 
teleprocessing program on a real machine. This paging activity may cause 
an increase in the time required to respond to the request compared with 
running the teleprocessing program on a real machine. Further response 
time is variable, depending upon the number of paging operations that 
must occur. 

Locking specific pages of the virtual machine *s program into real 
storage may ease this problem, but it is not always easy nor possible to 
identify which specific pages will always be required. 

Once a page is locked, it remains locked until either the user logs 
off or the system operator (privilege class A) issues the UNLOCK command 
for that page. If the "locked pages" option is in effect and the user 
loads his system again (via IPL) or loads another system, the locked 
pages are refreshed and the virtual machine's locked pages are unlocked 
by the system. The SYSTEM CLEAR command, when invoked, clears virtual 
machine storage, including the user's locked pages. 
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Note : In attached processor mode, no shared pages are locked. If the 
system operator attempts to lock a shared page or an address range 
containing one or more shared pages, he vill receive the message 

DMKCPV165I PAGE (hexloc) NOT LOCKED, SHARED PAGE 

for each of the shared pages within the range. 



KESER?ED PAGE FRAMES OPTION 

A more flexible approach than locked pages is the reserved page frames 
option. This option provides a specified virtual machine with an 
essentially private set of real page frames, the number of frames being 
designated by the system operator, when he issues the CP SET RESERVE 
command line* Pages will not be locked into these frames. They can be 
paged out, but only for other active pages of the same virtual machine. 
When a temporarily inactive virtual machine having this option is 
reactivated, these page frames are immediately available. If the 
program code or data required to satisfy the request was in real storage 
at the time the virtual machine became inactive, no paging activity is 
required for the virtual machine to respond. 

This option is usually more efficient than locked pages in that the 
pages that remain in real storage are those pages with the greatest 
amount of activity at that moment, as determined automatically by the 
system. Although multiple virtual machines may use the LOCK option, 
only one virtual machine at a time may have the reserved page frames 
option active. Assignment of this option is discussed further in 
"Preferred Virtual Machines." 

The reserved page frames option provides performance that is 
generally consistent from run to run with regard to paging activity. 
This can be especially valuable for production- oriented virtual machines 
with critical schedules, or those running teleprocessing applications 
where response times must be kept as short as possible. 



7IRT0AL=REAL OPTION 

The VH/370 virtual=real option eliminates CP paging for the selected 
virtual machine. All pages of virtual machine storage, except page 
zero, are locked in the real storage locations they would use on a real 
computer. CP controls real page zero, but the remainder of the CP 
nucleus is relocated and placed beyond the virtual=real machine in real 
storage. This option is discussed in more detail in "Preferred Virtual 
Machines." 

Since the entire address space required by the virtual machine is 
locked, these page frames are not available for use by other virtual 
machines except when the virtual=real machine is not logged on. This 
option often increases the paging activity for other virtual machine 
users, and in some cases for VM/370. (Paging activity on the system may 
increase substantially, since all other virtual machine storage 
requirements must be managed with fewer remaining real page frames.) 
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The virtual=real option may be desirable or mandatory in certain 
situations. The virtual=real option is desirable when running a virtual 
■achine operating system (like DOS/VS or OS/VS) that performs paging of 
its own because the possibility of double paging is eliminated. The 
option must be used to allow programs that execute self-modifying 
channel programs or have a certain degree of hardware timing 
dependencies to run under VM/370. 



Preferred Virtual Machine Options 

VM/370 provides seven functions that create a special virtual machine 
environment: 

1. Favored execution 

2. Priority 

3. Reserved page frames 

4. Virtual=real option 

5. Affinity 

6. Virtual machine assist 

7. Extended Control-Program Support 

The first five functions are designed to improve the performance of a 
selected virtual machine; the last two functions improve the performance 
of VM/370. Although each of the first five functions could be applied 
to a different virtual machine, usually they are applied to only one if 
optimum performance is reguired for that one specific virtual machine. 
The sixth and seventh functions can be applied to as many virtual 
machines as desired. 



FAVORED EXECUTION 

The favored execution options allow an installation to modify the normal 
scheduling algorithms and force the system to devote more of its 
processor resources to a given virtual machine than would ordinarily be 
the case. The options provided are: 

1. The basic favored execution option. 

2. The favored execution percentage option. 

The basic favored execution option means that the virtual machine so 
designated is not to be dropped from the active (in gueue) subset by the 
scheduler, unless it becomes nonexecutable. When the virtual machine is 
executable, it is to be placed in the dispatchable list at its normal 
priority position. However, any active virtual machine represents 
either an explicit or implicit commitment of main storage. An explicit 
storage commitment can be specified by either the virtual=real option or 
the reserved page frames option. An implicit commitment exists if 
neither of these options is specified, and the scheduler recomputes the 
virtual machine's projected work-set at what it would normally have been 
at gueue-drop time. Multiple virtual machines can have the basic 
favored execution option set. However, if their combined main storage 
reguirements exceed the system's capacity, performance can suffer 
because of thrashing. 

If the favored task is highly compute bound and must compete for the 
processor with many other tasks of the same type, an installation can 
define the processor allocation to be made. In this case, the favored 
execution percentage option can be selected for one virtual machine. 
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This option specifies that the selected virtual machine, in addition to 
regaining in queue, is guaranteed a specified minimum percentage of the 
total processor time if it can use it- The favored execution option can 
only he invoked by a system operator with command privilege class 1. 
The format of the command is as follows: 

r i 

SET FAVORED userid Inn I 

L J 



where: 

userid identifies the virtual machine to receive favored execution 
status. 

nn is any value from 1 through 99 and specifies the percentage 
of the in-queue time slice that is guaranteed to this 
virtual machine. 

OFF specifies that the virtual machine is to be removed from 
favored execution status. 

The percentage option of the SET FAVORED command is administered as 
follows: 

1. The in-queue time slice is multiplied by the specified percentage 
to arrive at the virtual machined guaranteed processor time. 

2. The favored virtual machine, when it is executable, is always 
placed at the top of the dispatchable list until it has obtained 
its guaranteed processor time. 

3. If the virtual machine obtains its guaranteed processor time before 
the end of its in-queue time slice, it is placed in the 
dispatchable list according to its calculated dispatching priority. 

4. In either case (2 or 3), at the end of the in-queue time slice the 
guarantee is recomputed as in step 1 and the process is repeated. 

Whether or not a percentage is specified, a virtual machine with the 
favored execution option active is kept in the dispatching queues except 
under the following conditions: 

• Entering CP console function mode 

• Loading a disabled PSW 

• Loading an enabled PSW with no active I/O in process 

• Logging on or off 

When the virtual machine becomes executable again, it is put back on the 
executable list in Q1. If dropped from Q1, the virtual machine is 
placed directly in Q2 and remains there even though it may exhaust its 
allotted amount of processor usage. Virtual machines with this option 
are thus considered for dispatching more frequently than other virtual 
machines. 

Note, however, that these options can impact the response time of 
interactive users and that only one favored percentage user is allowed 
at any given time. 
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PRIORITY 

The VM/370 operator can assign specific priority values to different 
virtual machines. In so doing, the virtual machine with a higher 
priority is considered for dispatching before a virtual machine with a 
lower priority. User priorities are set by the following class 1 
command: 

SET PRIORITY userid nn 

where userid is the user's identification and nn is an integer value 
from 1 to 99* The value of nn affects the user*s dispatching priority 
in relation to other users in the system. The priority value (nn) is 
one of the factors considered in VM/370 1 s dispatching algorithm. 
Generally, the lower the value of nn, the more favorable the user's 
position in relation to other users in VM/370's dispatch queues. 



RESERVED PAGE FRAMES 

VM/370 uses chained lists of available and pageable pages. Pages for 
users are assigned from the available list, which is replenished from 
the pageable list. 

Pages that are temporarily locked in real storage are not available 
or pageable. The reserved page function gives a particular virtual 
machine an essentially "private' 1 set of pages. The pages are not 
locked; they can be swapped, but only for the specified virtual machine. 
Paging proceeds using demand paging with a "reference bit" algorithm to 
select the best page for swapping. The number of reserved page frames 
for the virtual machine is specified as a maximum. The page selection 
algorithm selects an available page frame for a reserved user and marks 
that page frame "reserved" if the maximum specified for the user has not 
been reached. If an available reserved page frame is encountered for the 
reserved user selection, it is used whether or not the maximum has been 
reached. 

The maximum number of reserved page frames is specified by a class A 
command of the following format: 

SET RESERVE userid xxx 

where xxx is the maximum number reguired. If the page selection 
algorithm cannot locate an available page for other users because they 
are all reserved, the algorithm forces the use of reserved pages. This 
function can be specified in only one virtual machine at any one time. 

N ote : xxx should never approach the total available pages, since CP 
overhead is substantially increased in this situation, and excessive 
paging activity is likely to occur in other virtual machines. 



VIRTOAL=REAL 

For this option, the VM/370 nucleus must be reorganized to provide an 
area in real storage large enough to contain the entire virtual=real 
machine. In the virtual machine, each page from page 1 to the end is in 
its true real storage location; only its page zero is relocated. The 
virtual machine is still run in dynamic address translation mode, but 

1-32 IBM VM/370 System Logic and Problem Determination — Volume 1 



since the virtual page address is the sane as the real page address , no 
CCW translation is required. . Since CCW translation is not performed, no 
check is made to ensure that I/O data transfer does not occur into page 
zero or any page beyond the end of the virtual=real machine's storage. 

Systems that are generated with the virtual=real option use the 
system loader (DHKLDOOE) . For information about generating a 
virtual=real system, see the VM/370 Planning and System Generation 
Guide. 

Figure 12 is an example of a real storage layout with the 
virtual=real option. The V=R area is 128K and real storage is 512K. 
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Figure 12. Storage Layout in a Virtual=Real Machine 



There are several considerations 
affect overall system operation: 



for the virtual=real option that 



The area of contiguous storage built for the virtual=real machine 
must be large enough to contain the entire addressing space of the 
largest virtual=real machine. The virtual=real storage size that a 
VM/370 system allows is defined during system generation when the 
option is selected. 

The storage reserved for the virtual=real machine can only be used 
by a virtual machine with that option specified in the VM/370 
directory. It is not available to other users for paging space, nor 
for VM/370 usage until released from virtual^real status by a 
system operator via the CP UNLOCK command. Once released, VM/370 
must be loaded again before the virtual=real option can become 
active again. 
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3- The virtual Machine with the virtual=real option operates in the 
preallocated storage area with normal CCfl translation in effect 
until the CP SET NOTRANS ON command is issued, it that time, with 
several exceptions, all subsequent I/O operations are performed 
from the virtual CCWs in the virtual=real space without 
translation. The exceptions occur under any of the following 
conditions: 

• SIO tracing active 

• First CCH not in the V=R region 

• I/O operation is a sense command 

• I/O device is a dial-up terminal 

• I/O is for a nondedicated device 

(spooled unit record console virtual CTCA 

or minidisks that are less than a full volume) 

• Pending device status 

• I/O device has an alternate path 

Any of the above conditions will force CCW translation. Since 
minidisks are nondedicated devices, they may be used by programs 
running in the V=R region even though CP SET NOTRANS OH is in 
effect. 

4. If the virtual=real machine performs a virtual reset or IPL # then 
the normal CCW translation goes into effect until the CP SET 
NOTRANS ON command is again issued. This permits simulation of an 
IPL sequence by CP. Only the virtual=real virtual machine can 
issue the command. A message is issued if normal translation mode 
is entered. 

5. A virtual=real machine is not allowed to IPL a named or shared 
system. It must IPL by device address. 

6. When NOTRANS is in effect for a virtual=real machine, no meaningful 
SEEK data is collected by MONITOR operations. 



AFFINITY 

This virtual machine option allows virtual machines that operate on 
attached processor systems to select, if desired, the processor of their 
choice for program execution. The selection can be made by the VM/370 
directory OPTION statement, or it can be made dynamically by an operand 
of the CP SET command: 

For class G users 



SET AFFINITY Jnn ) 
\OFFJ 

For class A users 

SET AFFINITY userid ( nn ) 

Jon \ 
(off) 



where nn is the processor address of the main or the attached processor. 

In application, the affinity setting of a virtual machine implies a 
preference of operation to either (or neither) processor. Affinity of 
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operation for a virtual machine means that the program of that virtual 
machine vill he executed on the selected or named processor. It does 
not imply that supervisory functions and the CP housekeeping functions 
associated with that virtual machine will be handled by the same 
processor. 

In attached processor systems, all real I/O operations and associated 
interrupts are handled by the main processor. Virtual I/O initiated on 
the attached processor that is mapped to real devices must transfer 
control to the main processor for real I/O execution. Therefore, 
benefits may be realized in a virtual machine "mix" by relegating those 
virtual machines that have a high I/O-to-compute ratio to the main 
processor, and those virtual machines that have a high compute-to-I/O 
ratio to the attached processor. Such decisions should be carefully 
weighed as every virtual machine is in contention with other virtual 
machines for resources of the system. 

A more important use of the affinity setting would be in applications 
where there are virtual machine program requirements for special 
hardware features that are available on one processor and not the other. 
Such features could be a performance enhancement such as virtual machine 
assist (described later in the text) or a special RPQ that is a 
requirement for a particular program's execution. 



VIRTUAL MACHINE ASSIST FEATURE 

The virtual machine assist feature is a processor hardware feature. It 
improves the performance of VM/370. Virtual storage operating systems, 
which run in problem state under the control of VM/370, use many 
privileged instructions and SVCs that cause interrupts that VM/370 must 
handle. When the virtual machine assist feature is used, many of these 
interrupts are intercepted and handled by the processor; and, 
consequently, VM/370 performance is improved. See VM/370 Planning and 
S ystem Generation Guide for a list of the processors on which virtual 
machine assist is available. 

The virtual machine assist feature intercepts and handles 
interruptions caused by SVCs (other than SVC 76), invalid page 
conditions, and several privileged instructions. An SVC 76 is never 
handled by the assist feature; it is always handled by CP. The 
processing of the following privileged instructions is handled by this 
feature: 

LRA (load real address) 

STCTL (store control) 

RRB (reset reference bit) 

ISK (insert storage key) 

SSK (set storage key) 

IPK (insert PSW key) 

STNSH (store then AND system mask) 

STOSM (store then OR system mask) 

SSM (set system mask) 

LPSW (load PSW) 

SPKA (set PSW key from address) 

Although the assist feature was designed to improve the performance 
of VM/370, virtual machines may see a performance improvement because 
more resources are available for virtual machine users. 
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the Virtual Machine Assi st Feature 

Whenever you IPL VH/370 on a processor with the virtual machine assist 
feature, the feature is available for all VH/370 virtual Machines. 
However, the system operator's SET command can make the feature 
unavailable to VH/370 and, subsequently, available again for all users. 
The format of the systea operator 1 s SET command is: 

SET SASSIST /ON ) [[PROC] xx] 
(OFF/ 

If you do not know whether or not the virtual machine assist feature 
is available to VH/370, use the class A and E QUERY command. For a 
complete description of the Class A and E QUERY and SET commands, see 
the VH/370 Operator's Guide. 

If the virtual machine assist feature is available to VH/370 when you 
log on your virtual machine. i+ ir al?n supported for your virtual 
machine. If your VH/370 directory entry has the SVCOFF option, the SVC 
handling portion of the assist feature is not available when you log on. 
The class G SET command can disable the assist feature (or only disable 
SVC handling). It can also enable the assist feature, or if the assist 
feature is available, enable the SVC handling. The format of the 
command is: 

SET ASSIST ([ON] [SVC ] [THR ] ) 
< [NOSVC] [NOTHR] > 
( OFF j 

You can use the class G QUERY SET command line to find whether you have 
full, partial, or none of the assist feature available. For a complete 
description of the Class G QUERY and SET commands, see the V H/370 CP 
Command Reference for General Users. 



Restri cted Use of the Virtual Hachine Assist Feature 

Certain interrupts must be handled by VH/370. Consequently, the assist 
feature is not available under certain circumstances. VH/370 
automatically turns off the assist feature in a virtual machine if it: 

• Has an instruction address stop set. 

• Traces SVC and program interrupts. 

Since an address stop is recognized by an SVC interrupt, VH/370 must 
handle SVC interrupts while address stops are set. Whenever you issue 
the ADSTOP command, VH/370 automatically turns off the SVC handling 
portion of the assist feature for your virtual machine. The assist 
feature is turned on again after the instruction is encountered and the 
address stop removed. If you issue the QUERY SET command line while an 
address stop is in effect, the response will indicate that the SVC 
handling portion of the assist feature is off. 

Whenever a virtual machine issues a TRACE command with the SVC, PRIV, 
ERANCH, INSTRUCT, or ALL operands, the virtual assist feature is 
automatically turned off for that virtual machine. The assist feature 
is turned on again when the tracing is completed. If the QUERY SET 
command lice is issued while SVCs or program interrupts are being 
traced, the response will indicate the assist feature is off. 
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VM/370 EXTENDED CONTROL-PROGRAM SUPPORT (ECPS) 

VM/370 Extended Control-Program Support (ECPS) improves the performance 
of the processor when executing VM/370 beyond the improvement attained 
by the virtual machine assist feature described above. See VM/370 
P lanni ng and System Generation Guide for a list of the processors on 
which ECPS is available. ECPS consists of three parts: CP assist, 
expanded virtual machine assist, and virtual interval timer assist. A 
detailed description of ECPS is provided in "Appendix A. VM/370 Extended 
Control-Program Support." 

CP Assist 

The CP assist part of ECPS assists various routines that are frequently 
used by VM/370. Because these routines are assisted by the hardware 
without involving VM/370* performance of the VM/370 system is improved. 
The high-use paths of the following functions are assisted: 

Get Free Space (DMKFRE) 

Release Free Space (DMKFRE) 

Untranslate CSW (DMKDNT) 

Free CCW Storage (DMKDNT) 

Locate Virtual I/O Control Block (DMKSCN) 

Locate Real I/O Control Block (DMKSCN) 

Lock a page (DMKPTR) 

Unlock a page (DMKPTR) 

Common CCW command processing (DMKCCW) 

Decode First CCW command (DMKCCW) 

Decode following CCW command (DMKCCW) 

TRANBRNG subroutine (DMKCCW) 

TRANLOCK subroutine (DMKCCW) 

Invalidate page table subroutine (DMKVAT) 

Invalidate segment table subroutine (DMKVAT) 

Main entry to dispatch (DMKDSP) 

Dispatch a block or virtual machine (DMKDSP) 

SVC 8 (LINK) 

SVC 12 (RETURN) 

Locate changed shared pages (DHKVHA) 

Expand ed Virtual Machin e Assist 

Expanded virtual machine assist extends the level of handling of the 
following privileged instructions: 

• LPSW 

• STNSM 

• STOSM 

• SSM 

In addition, expanded virtual machine assist handles the processing 
of the following privileged instructions not handled by the virtual 
machine assist feature: 

• PTLB 

• SIO 

• SPT 

• SCKC 

• STPT 

• TCH 
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Virtual Interval Tig er Assist 

Virtual interval timer assist provides hardware updating of the virtual 
interval timer at virtual location X'SO*. This results in an update 
frequency of approximately 300 times per second, the same as for the 
real interval timer. Procedures that use the virtual interval timer for 
job accounting, performance measurements, and the like, will therefore 
generate more accurate and repeatable time data than they would if the 
virtual timer was being updated by CP routines. 



Using the VM^370 Extended C ontrol-P roq ram Support 

VM/370 Extended Control-Program Support (ECPS) is controlled at two 
levels: the VM/370 system and the virtual machine. 

it the VM/370 system level, ECPS is automatically enabled when the 
system is loaded. The class A command: 

set cpassist off 

will disable both CP assist and expanded virtual machine assist. The 
class A command: 

set sassist off 

disables only the expanded virtual machine assist part of ECPS as well 
as the virtual machine assist. CP assist is the only part of ECPS that 
is truly independent. 

At the virtual machine level, whenever ECPS is enabled on the system, 
both expanded virtual machine assist and virtual interval timer assist 
are automatically enabled when you log on. If you issue the class G 
command: 

set assist off 

both assists as well as the existing virtual machine assist are 
disabled. If you issue: 

set assist notmr 

only the virtual interval timer assist is disabled. If CP assist is 
disabled for the system, the class A command: 

set sassist on 

will enable the virtual machine assist. You can then enable virtual 
machine assist and virtual interval timer assist for your virtual 
machine by issuing the class A command: 

set assist on tmr 



Restri cted Use of ECPS 

The restrictions on the use of ECPS are the same as those described for 
the virtual machine assist feature with one addition. Whenever a 
virtual machine traces external interrupts, the virtual interval timer 
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assist is automatically disabled. When external interrupt tracing is 
completed, virtual interval timer assist is reenabled. 



Virtual Machine Communication Facility 

The Virtual Machine Communication Facility (VMCF) allows any logged-on 
user of VM/370 to transfer messages, control data, data files, or 
combinations of all three to another virtual machine running under the 
same VM/370 system. Information is transferred directly from one 
virtual storage to the other virtual storage with CP buffering the 
information. Only one data page frame must be locked at any one time. 
The amount of data that can be transferred is limited only by the 
virtual storage sizes of the virtual machines involved. 
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invoked by a virtual machine via the DIAGNOSE interface (code X'OOeS 1 )- 
A special external interrupt code, X'4001', notifies a virtual machine 
that a VHCF communication is pending. A virtual machine can have a 
maximum of 50 messages active at any one time. The number of messages 
is an equate in the DMKVMC module and can be changed to accommodate 
different VM/370 storage sizes. 



VMCF Diagnose Interface 



When a virtual machine issues a DIAGNOSE instruction with a function 
code of X'OOeS*, the rx register contains the virtual address, 
doubleword-aligned, of a 40- byte parameter list. This parameter list 
(VMCPARM) contains a hexadecimal code to identify the specific VMCF 
subfunction. It also contains the data addresses, data lengths, and 
control information that are required to execute the particular 
subfunction. 

The DIAGNOSE instruction, a privileged operation, is processed by 
DMKPRV which passes control to DMKHVC, the DIAGNOSE interface module. 
DMKHVC, in turn, validates the function code and, if the code is 
X s 0068 ! , turns control over to DMKVMC, the VMCF module. DMKVMC 
validates the VMCPARM address and length, the subfunction code, and 
passes control to the appropriate subroutine. The VMCF subf unctions and 
their codes are as follows: 



Code 

X'0000 1 

X»0001» 

X»0002« 

X«0003» 

X'OOOIP 

x^ooos 1 
x»ooo6» 

X»0007« 
X»0008« 
X«0009» 
X'OOOA 1 
X'OOOB* 



Subfunction 

Allow virtual machine communication 

Disallow virtual machine communication 

Initiate a SEND request 

Initiate a SEND/RECV request 

Initiate a SENDX request 

Accept data from a SEND or SEND/RECV request 

Cancel specific request you initiated 

Reply to a SEND/RECV request 

Reject further incoming communications 

Resume accepting communications 

Notify a user that you are ready for communications 

Reject a specific incoming communication 
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Special VHCF External Interrupt 

Whenever a source virtual machine uses VHCF to correspond with another 
virtual Machine (sink), the sink is notified of the pending 
communication via a special external interrupt (code X'4001') . When 
this interrupt is unstacked and processed, a copy of the information in 
the source's parameter list is passed to the sink in an external 
interrupt buffer. The buffer is defined when a user allows virtual 
machine communication. The contents are referred to as the external 
interrupt message header. 

When certain transactions (SEND, SEND/RECV, SENDI) have been 
completed, a final response external interrupt is passed back to the 
source. The message header associated with this interrupt contains 
residual counts pertaining to the transferred data and data transfer 
return codes. 



VHCF Control Blocks an3 Dsta ir^as 

Figure 13 shows the relationship between the various VHCF control blocks 
and data areas. When a virtual machine allows virtual machine 
communication, VHCF generates a master VHCBLOK and places it at the head 
of a queue pointed to by the VHCPNT field of the user's VHBLOK. Two 
fields in this master VHCBLOK define the address (VHCVADA) and length 
(VHCLENA) of the user's external interrupt buffer. The length must 
include the maximum size of any potential SENDX data in addition to the 
40 bytes for the external interrupt message header. 

When a source virtual machine executes a VHCF subf unction, a VHCBLOK 
is built, initialized with data from the parameter list (VHCPARH) , and 
stacked on the VHCBLOK queue pointed to by the VHCPNT field in the 
sink's VHBLOK. If an XINTBLOK for a X'4001' external interrupt has not 
already been stacked for the sink machine, DHKVHC builds one and stacks 
it on the XINTBLOK queue pointed to by the VHPXINT field in the sink's 
VHBLOK. VHCF external interrupts are assigned a sort code of 
X'7FFFFFFF', giving them the lowest priority in the external interrupt 
queue. Each virtual machine clears its own VHCF control blocks. 



i Special Messages Facility 



I The Special Hessage Facility allows users to send special messages to a 

| virtual machine via the SHSG command. In the Special Hessage 

I environment, CP acts as a source machine with the receiver of special 

I messages being the sink. This relieves the burden from the issuer of 

| SHSG of having to perform authorization and other setup necessary for 

I sending messages to the receiving virtual machine. This is performed by 

I CP. 

I The issuer of SHSG is responsible for sending message text that is 

I meaningful to the receiving virtual machine. The format and handling of 

I special messages is entirely up to the receiving machine, which may be 

I one designed by the installation or prepared by others. 

i Before the receiving virtual machine can accept special messages, it 

I must be running with the Special Hessage flag ON, and it must have 

I issued AUTHORIZE (via DIAGNOSE X'68') with CP. The authorization 

i includes supplying the External Interrupt Buffer address and size. To 

! ensure receiving the entire message, the receiving virtual machine 
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Master 
VMCBLOK 



VMCVADA 



External Interrupt 
Buffer 



(VMCMHDR) 



Optional SENDX 
Data Buffer 



Figure 13. VMCF Control Block Relationships 



should specify the size as 169 bytes (room for a 40-byte header and a 
120- to 129-byte message buffer, depending on the length of the coaaand 
and userid) . 

Setting SMSG ON can be accoiplished by setting the SHSG flag on in 
the VMCF paraaeter list when issuing an AUTHORIZE. It Bay also issue 
the CP coaaand SET SHSG ON. Either aethod sets the Special Message flag 
on in the VMBLOK. When this is done, any other virtual machine can 
issue the SMSG coaaand to the userid of the receiving virtual Machine. 
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If the receiving virtual machine chooses not to accept special 
messages at any time, it can merely issue SET SHSG OFF. CP would then 
inform any machine issuing the SMSG command that the virtual machine is 
not receiving special messages. When it is ready to resume accepting 
special messages, the Virtual machine need only to issue SET SMSG OH. 

The following shows the processing when an SHSG command is issued. 



| SMSG userid msgtxt | 

i : : 1 



CP: 



Validates SHSG command. 
Checks that receiving virtual machine 
has Special Message flag ON (in receiving 
aachins , c VMSLOK) If not -- 

Checks for receiving virtual machine being 
authorized with CP. If not — 

Obtains storage for containing one VMCF 
External Interrupt Buffer. 
Builds VMCF parmeter list: 

- saves buffer address in VHVHVADA 

- computes message length & stores that 
length in VHVHLENA 

- ioves message test into area pointed to 
BY VHCHBUF (VHCHVADA value minus 40 
bytes) for the computed length of the 
message text 

- stores SENDX subfunction code in 
VMCMFONC 

- stores CPO clock value in VHCHHID as a 
unigue message-id 

Calls DHKVHC to execute SENDX subfunction 
code to send the message to the receiving 
virtual machine. 



-T- 



| Send message to 
I issuer that 
I receiving machine 
lis not receiving 
| special messages 



T 

EXIT 



I Receiving virtual machine processes data | 
I from buffer transmitted via SENDX. | 

i . „ ... „ „ , , , , ,i 



During a Special Message session, the following error messages could be 
sent back to the issuer of the SMSG command: 

DMKHSG003E: INVALID OPTION - option 
DMKMSG020E: DSERID HISSING OR INVALID 
DHKHSG045W: userid NOT LOGGED ON 

DMKHSG057E: userid NOT RECEIVING; [DISCONNECTED | HSG OFF | 
SHSG OFF | NOT AUTHORIZED | WNG OFF] 
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VM/VS Handshaking 



The VM/VS Handshaking feature provides a communication path between CP 
and virtual machine operating systems that makes each system control 
program aware of certain capabilities or requirements of the other. 

The following is a discussion of VM/VS Handshaking as it relates to 
0S/VS1. Functions of VM/VS Handshaking incorporated in the VM/370 
control program are available and applicable to any operating system 
that can be system generated to use this VM/370 enhancement. 

VM/VS Handshaking for 0S/VS1 performs the following functions: 

• closes CP spool files when the VS1 job output from its DSG, 
terminator, and output writer is complete 

• Processes VS1 pseudo page faults 

• Provides an optional nonpaging mode for VS1 when it is run in the 
VM/370 environment 

When a VS1 virtual machine with the handshaking feature is loaded 
(via IPL) , its initialization routines determine whether the handshaking 
feature should be enabled. First, VS1 determines if it is running under 
the control of VM/370 by issuing a STIDP (Store Processor ID) 
instruction. STIDP returns a version code; a version code of X*FF* 
indicates VS1 is running with VM/370. If VS1 finds a version code of 
X'FF', it then issues a DIAGNOSE (X'OO 1 ) instruction to store the VM/370 
extended-identification code. If an extended-identification code is 
returned to VS1, VS1 knows that VM/370 supports handshaking; if nothing 
is returned to VS1, VM/370 does not support handshaking. At this time 
or any time after IPL, the operator of the VS1 virtual machine can issue 
the CP SET PAGEX ON command to enable the pseudo page fault handling 
portion of handshaking. If the VS1 virtual machine is in the nonpaging 
mode and, if the pseudo page fault handling is active, full handshaking 
support is available. 

Because the VS1 system does no paging, any ISAM programs run under 
VS1 are treated by VM/370 as though they are running in an ADDRSPC=HEAL 
partition. Therefore, the ISAM option is required for the VS1 machine 
to successfully execute the ISAM program. 

Closing CP Spool Files 

If the handshaking feature is active, VS1 closes the CP spool files when 
its job output from the DSO, terminator, and output writer is complete. 
Once the spool files are closed, VM/370 processes them and they are sent 
to the real printer or punch. During its job termination processing, 
VS1 issues a DIAGNOSE (X^OS 1 ) instruction to pass the CP CLOSE command 
to VM/370 for each CP spool file. 



Pseudo Page Faults 

A page fault is a program interruption that occurs when a page marked 
"not in storage" is referred to by an instruction with an active page. 
The virtual machine referring to the page is placed in a wait state 
while the page is brought into real storage. Without the handshaking 
feature, the entire VS1 virtual machine is placed in page wait by VM/370 
until the needed page is available. 
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However, with the handshaking feature, a multiprogramming (or 
Multitasking) VS1 virtual machine can dispatch one task while waiting 
for a page request to be answered for another task. VH/370 passes a 
pseudo page fault (program interrupt X'14') to VS1. When VS1 recognizes 
the pseudo page fault, it places only the task waiting for the page in 
page wait and can dispatch another tasks. 

When a page fault occurs for a VS1 virtual machine, VH/370 checks 
that the pseudo page fault portion of handshaking is active and that the 
TS1 virtual machine is in EC mode and enabled for I/O interruptions. 
Then, VM/370 reflects the page fault to VS1 by: 

• Storing the virtual machine address that caused the page fault at 
location X^O* (the translation exception address) 

• Indicating a program interruption (interrupt code X'14 1 ) to VS1 

• Removing the VS1 virtual machine from page wait and execution wait 

When VS1 recognizes program interruption code X'Hl', it places the 
associated task in wait state. VS1 can then dispatch other tasks. 

When the requested page becomes available in real storage, VH/370 
indicates the same program interruption to VS1, except that the leftmost 
bit in the translation exception address field is set on to indicate 
completion. VS1 removes the task from page wait; the task is then 
eligible to be dispatched. 



VS1 Nonpaging Mode 

When VS1 runs under the control of VH/370, it executes in nonpaging mode 
if: 

• Its virtual storage size is equal to the size of the VM/370 virtual 
machine 

• Its virtual machine size is at least 1024K bytes and no more than 
4096K bytes. For VS1 Release 6, the maximum size is 16,370K bytes. 

• The VH/VS Handshaking feature is available. 

When VS1 executes in nonpaging mode, it uses fewer privileged 
instructions and avoids duplicate paging. The VS1 Nucleus 
Initialization Program (NIP) fixes all VS1 pages to avoid the duplicate 
paging. 

Note : The working set size may be larger for a VS1 virtual machine in 
nonpaging mode than for one in paging mode. 
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Miscellaneous E nhancement s 

A YS1 virtual machine with the handshaking feature avoids many of the 
instructions or procedures that would duplicate the function that VH/370 
provides. For example, VS1 avoids; 

• ISK (Insert Storage Key) instructions and uses a key table 

• Seek separation for 2314 direct access devices 

• ENABLE/DISABLE sequences in the VS1 I/O Supervisor (IOS) 

• TCH (Test Channel) instructions preceding SIO (Start I/O) 
instructions 
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CP Interruption Handling 



Interruption processing occurs within the CP environment . More than 30 
■odules control the process of interrupting events brought about by CP 
or virtual machine activity- Each module handles a particular I/O 
device or class or a function of CP, (for example: timers, paging, 
SYCs). For an overview of interruption handling, see Figure 14. 



Program Interruption 

Program interruptions occur in two states. If the CPO is in the 
supervisor state, the interruption indicates a system failure in the CP 
nucleus and causes a system abnormal termination. If the CPn is in the 
problem state, a virtual machine is in execution. If the program 
interruption indicates that the Dynamic Address Translation (DAT) 
feature has an exception, a virtual machine issued a privileged 
instruction, or a protection exception occurred for a shared segment 
system, CP takes control and performs any required processing to satisfy 
the exception. Usually, the interruption is not apparent to the virtual 
machine. Most other program interruptions result from virtual machine 
processing and are reflected to the virtual machine for handling . 

When a program interruption occurs, the program interruption handler 
(DHKPRG) is entered. Program interruptions can result from: 

• Normal paging requests 

• A paging request by a virtual machine in EC mode (virtual relocate 
mode) 

• Privileged instructions 

• Program errors 

For information about paging requests, see "Allocation Management" in 
this section. 



Privileged Instructions 

If a program interruption is caused by the virtual machine issuing a 
privileged instruction when it is running in supervisor state, DHKPRVLG 
obtains the address of the privileged instruction and determines the 
type of operation requested. If the virtual machine was running in 
problem state, the interruption is reflected back to the virtual 
machine. 



I/O PRIVILEGED INSTRUCTIONS 

DMKPRVLG transfers control to the virtual I/O executive program 
(DMKYSIEX). 
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Figure 14- Overview of Interruption Handling 



NON-I/0 PRIVILEGED INSTRUCTIONS 



DMKPRVLG simulates valid non-I/O privileged instructions and returns 
control to DMKDSPCH. For invalid non-I/O privileged instructions, the 
routine sets an invalid interruption code and reflects the interruption 
to the virtual machine. For the privileged instructions (SCK, SCKC, 
STCKC, SPT, and STPT) that affect the TOD clock, CPU timer, and TOD 
clock comparator, control is transferred to DMKTMR by DMKPRVLG. Other 
instructions that are simulated are LPSW, SSM, SSK, ISK, IPTE, and 
DIAGNOSE. 
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Although the CS and CDS instructions are nonprivileged, they are not 
part of the standard instruction set on IBM System/370 Models 135, 
135-3, 138, 145, 145-3, and 148; VM/370 simulates these instructions on 
these models that do not have the optional hardware feature installed. 

System/370 EC mode non-1/0 privileged instruction simulation includes 
the following: 



Code Definition 

SCK Set Clock 

SCKC Set Clock Comparator 

STCKC Store Clock Comparator 

SPT Set CPO Timer 

STPT Store CPU Timer 

STNSM Store and AND System Mask 

STOSM Store and OR System Mask 

STIDP Store CPO Identification 

STIDC Store Channel Identification 

LCTL Load Control 

STCTL Store Control 

LBA Load Real Address 

RRB Reset Reference Bit 

PTLB Purge Table Look-aside Buffer 

IPK Insert PSH Key 

SPKA Set PSH Key From Address 
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DIAGNOSE INSTRUCTION IN A VIRTUAL HACHINE 



The DIAGNOSE instruction cannot be used in a virtual machine for its 
normal function. If a virtual Machine attempts to execute a DIAGNOSE 
instruction, a program interrupt returns control to CP. Since a 
DIAGNOSE instruction issued in a virtual machine results only in 
returning control to CP and not in performing normal DIAGNOSE functions, 
the instruction is used for communication between a virtual machine and 
CP. The machine language format of DIAGNOSE is: 



4 bytes 



r 










i 


1 


83 


1 Rx 1 


1 Ry I 


CODE 


1 
i 




is X'83' and interpreted by the assembler as the DIAGNOSE 
instruction. 

Note; There is no mnemonic for DIAGNOSE. 

Rx specifies a register containing the address of the VHCPARH 
parameter list. 

Ry is a register that contains a return code. 

CODE is X^S 1 and specifies that you are requesting execution of a 
VMCF. 

The operand storage addresses, passed to the DIAGNOSE interface in Rx 
and Ry, must be real addresses to the virtual machine issuing the 
DIAGNOSE. 

The code is a two-byte hexadecimal value that CP uses to determine 
what function to perform. The codes defined for the general VH/370 user 
are described in this section. The code must be a multiple of 4. Codes 
X'OO 1 through X'FC are reserved for IBH use, and codes XMOO* through 
XMFC* are reserved for users. 

Because DIAGNOSE operates differently in a virtual machine than it 
does in a real machine, a program should determine that it is operating 
in a virtual machine before issuing a diagnose instruction, and prevent 
execution of a DIAGNOSE when in a real machine. The Store Processor ID 
(STIDP) instruction provides a program with information about the 
processor in which it is executing, including the processor version 
number. If STIDP is issued from a virtual machine, the version number 
will be I'FF' in the first byte of the CPUID field. 

A virtual machine issuing a diagnose instruction should run with 
interrupts disabled. This prevents loss of status information 
pertaining to the diagnose operation such as condition codes and sense 
data. 
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DIAGNOSE Code X'OO^ -- Store Extended-Identification Code 

Execution of DIAGNOSE code X'OO* allows a virtual machine to examine the 
VM/370 extended- identification code. For example, an 0S/VS1 virtual 
machine issues a DIAGNOSE code X'OO* instruction to determine if the 
version of VM/370 under which it is executing supports the VM/VS 
Handshaking feature. If the extended- identification code is returned to 
VS1, VM/370 supports handshaking; otherwise, it does not. 

The register specified as Rx contains the doubleword aligned virtual 
storage address where the VM/370 extended- identification code is to be 
stored. The Ry register contains the number of bytes to be stored 
entered as an unsigned binary number. 

If the VM/370 system currently executing does not support the 
DIAGNOSE code X^OO 1 instruction, no data is returned to the virtual 
machine. If it does support the DIAGNOSE code X'OO* instruction, the 
following data is returned to the virtual machine (at the location 
specified by Rx) : 



Field 

System 

Name 



Description 
"VM/370" 



Chara cterist i cs 
8 bytes, EBCDIC 



Version 
Number 



Version 
Code 



The first byte is the 
version number, the second 
byte is the level, and the third 
byte is the PLC (Program Level 
Change) number. 

VM/370 executes the STIDP 
(Store Processor ID) instruction 
to determine the version 
code. 



3 bytes, hexadecimal 



1 byte, hexadecimal 



MCEL 



Processor 
Address 



VM/370 executes the STIDP 
instruction to determine 
the maximum length of the 
MCEL (Machine Check Extended 
Logout) area. 

VM/370 executes the STAP 
(Store Processor Address) instruction 
to determine the processor 
address. 



2 bytes, hexadecimal 



2 bytes, hexadecimal 



Oserid 



Program 
Product 
Bit Map 



The userid of the virtual 
machine issuing the DIAGNOSE 

Reserved for IBM use 



8 bytes, EBCDIC 



8 bytes, hexadecimal 



If VM/370 is executing in a virtual machine, another 24 bytes, or 
less, of extended identification data is appended to the first 24 bytes 
described above. Op to five nested levels of VM/370 virtual machines 
are supported by this diagnose instruction resulting in a maximum of 120 
bytes of data that can be returned to the virtual machine that initially 
issued the diagnose instruction. 



Upon return, Ry contains its original 
that were stored. 



value less the number of bytes 



No completion 
unchanged. 



code is returned, and the condition code remains 
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DIAGNOSE Code X»04' -- Examine Real Storage 

Execution of a DIAGNOSE code X'04* allows a user with command privilege 
class C or E to examine real storage. The register specified as Rx 
contains the virtual address of a list of CP (real) addresses to be 
examined. The Ry register contains the count of entries in the list. 
Ry+1 contains the virtual address of the result field. The result field 
contains the values retrieved from the specified real locations. 

Note ; The request and result tables must be in the same page of virtual 
storage, and that page must be resident in real storage, at the time the 
DIAGNOSE is executed. This is guaranteed if the instruction itself is 
also in the same page. 

In the attached processor environment, each processor has a prefix 
register to relocate addresses between and 4095 to another page frame 
in main storage. The prefix register enables each processor to use a 
different page frame in order to avoid conflict with the other processor 
for such activity as interrupt code recording. Thus, the range 
through 4095 refers to different areas of storage, depending upon which 
processor generates the address. 

All references to main storage from either processor are handled as 
if they were made on the main processor. Existing user programs remain 
valid for performance data; in the attached processor environment, they 
receive the statistics for the main processor. 

References to the PSA of the attached processor may be made as 
follows: first, retrieve the value of PREFIXB, the value of the prefix 
register for the other processor (the attached processor in this case) . 
Next, specify addresses that are the sum of the value of PREFIXB and the 
PSA displacement. References to through 4095 are made by summing the 
value of PREFIX A and the PSA displacement to form the request address. 
Several system values that are processor independent are maintained in 
through 4095, such as the restart PSW and the trace table vectors. 

DIAGNOSE Code XM)8J. zz. Xifisal Console Function 

The execution of DIAGNOSE code X*08* allows a program executing in 
supervisor mode in a virtual machine to perform a CP command. The 
register specified as Rx contains the address, in virtual storage, of 
the data area defining the CP command and parameters. The Ry register 
contains flags in the high- order byte, and contains the command length 
(up to 132 characters) in the three low-order bytes. If the first bit 
of the high-order bytes is on (X^O 1 ), it indicates that the virtual 
machine issuing the DIAGNOSE code X'OS 1 instruction wants CP to reject 
passwords from the terminal for ADTOLOG and LINK commands. This will be 
done only if the installation has elected to use the password 
suppression facility (PSUPRS=YES parameter of the SYSJRL macro in 
DMKSYS) . 

If the second bit of the high-order byte is on (X^O 1 )* it indicates 
that the virtual machine issuing the CP command requires the response to 
that command to be returned to the virtual storage area specified by 
register Rx+1. The length of this area must be passed in register Ry+1. 
The following example illustrates how DIAGNOSE code X 1 08» would be 
issued to perform the CP command, QUERY, to determine the number of 
input and output spool files: 
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LA 6,CMMD 

LA 10,CMMDL 

DC X'83',X«6A',XL2'0008' 



CMHD DC C QUERY FILES' 
CHHDL EQD *-CHMD 



If the high- order byte of the Ry register is an X»40', the output of 
the coamand is returned to the user's virtual storage area; otherwise, 
it is at the user's terminal. A conpletion code is returned to the user 
as a value in the register specified as Ry. In the example above, it 
would be register 10. A completion code of signifies normal 
conpletion. If there is an error, the completion code is the binary 
value of the numeric portion of the error message. For instance, the 
error message 

DHKCFH045E userid NOT LOGGED ON 

returns n 045 n in the Ry register. The condition code remains unchanged. 

If a CP command is to be executed, the instruction acts as a no-op. If 
Ry contains a zero, CP is entered. The BEGIN command then returns 
control to your program. 

The user can have the response returned in a buffer rather than to his 
console. He is entirely responsible for setting up the buffer, 
providing the buffer address, and examining and processing the returned 
response (contents of the buffer) . To have the response returned in the 
buffer, the user sets up registers as follows: 

Rx contains the virtual address of the CP console functions 
command and parameters. 

Rx*1 contains the virtual address of the buffer to receive the 
response. 

Ry contains the length of the CP console function command (up to 
132 characters) with an X'40' in the high-order byte. 

Ry+1 contains the length of the response buffer (a positive number 
not greater than 8192) . 

Neither Rx nor Ry can be register 15; Rx and Ry cannot be consecutive 
registers. 

When returned in a buffer, the DIAGNOSE code X»08' output will also have 
the following successful or unsuccessful conditions set: 

• If the response fits into the user's buffer, the condition code is 
set to zero and the number of response characters returned in the 
user's buffer is returned in Ry*1. 

• If the response does not fit in the user's buffer, the condition code 
is set to one, and the amount of overflow (number of response bytes 
that would not fit in the user's buffer) is returned in register 
Ry*1. 
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DIAGNOSE Code X»0C* — Pseud o Timer 



Execution of DIAGNOSE code X'OC causes CP to store four doublewords of 
time information in the user*s virtual storage- The register specified 
as Rx contains the address of the 32-byte area where the time 
information is to be stored. The address must be on a doubleword 
boundary. 

The first eight bytes contain the month/da y- of -month/year . The next 
eight bytes contain the time of day in hours:minutes:seconds. 
One-hundredths of seconds are not returned. The last 16 bytes contain 
the virtual and total processor time used by the virtual machine that 
issued the DIAGNOSE. These times are expressed as doubleword, unsigned 
integers, in microseconds. No completion code is returned, and the 
condition code remains unchanged. 

DIAGNOSE Code XM <P -- Release Pages 

Pages of virtual storage can be released by issuing a DIAGNOSE code 
X'10'. When a page is released, it is considered all zero. The 
register specified by Rx contains the address of the first page to be 
released, and the Ry register contains the address of the last page to 
be released. Both addresses must be on page boundaries. A page 
boundary is a storage address whose low- order three digits, expressed in 
hexadecimal, are zero. No completion code is returned, and the 
condition code remains unchanged. 

I Note; DIAGNOSE code X'10' is not to be used to release discontiguous 
I storage. See DIAGNOSE code X'64* for releasing discontiguous storage. 



DIAGNOSE Code XM**' -- Input Spool File Manipulation 

Execution of DIAGNOSE code X'14' causes DHKDRDER to perform input spool 
file manipulation. Depending upon the value of the function subcode, 
the register specified as Rx contains a buffer address, a copy count, or 
a spool file identifier. The Ry register, which must be an even 
register, contains either the virtual address of a spool input card 
reader or, if Ry*1 contains X»0FFF', a spool file ID number. Ry+1 
contains a hexadecimal code indicating the file manipulation to be 
performed. The codes are: 

Code Function 

0000 Read next spool buffer (data record) 

0004 Read next print spool file block (SFBLOK) 

0008 Read next punch spool file block (SFBLOK) 

000C Select a file for processing 

0010 Repeat active file nn times 

0014 Restart active file at beginning 

0018 Backspace one record 

00 1C Read next monitor spool file block 

0020 Read next monitor spool record 

0FFF Retrieve subsequent file descriptor 
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On return Ry + 1 may contain error codes that further define a returned 
:ondition code of 3. 



Error 

Data transfer successful 

End of file 

File not found 

Device address invalid 

Device type invalid 

Device busy 

Fatal paging I/O error 

Page already locked for I/O 



Condition 




Code 


EI±. 







1 




2 




3 


4 


3 


8 


3 


12 


3 


16 


3 


20 



y» onnni 



Rx = start address of fullpage virtual buffer 
Ry = virtual spool reader address 

The specified device is checked for a file already activated via 
DIAGNOSE and, if there is one, the next fullpage buffer is made 
available to the virtual machine via a call to DHKRPAGT. If no file is 
active via DIAGNOSE, the chain of reader files is searched for a file 
for the calling user and connected to the virtual device for further 
reading. If no file is found, virtual condition code 2 is set. When the 
end of an active file is reached, the device status settings are tested 
for "spool continuous." • If not set, virtual condition code 1 is set, 
indicating end of file. If the device is set for continuous input, the 
active file is examined to determine whether or not it is a 
multiple-copy file. If it is, reading is restarted at the beginning of 
the file. If it is not, the file is closed via DHKVSPCR and the reader 
chain is searched for another input file. If no other file is found, 
virtual condition code 1 is set. A specific DIAGNOSE I'H' Subcode 
X'OOOO* must be issued to get the first spooled page again. 



Subcode X'OOOa* 

Rx = virtual address of a 12-doubleword buffer 
Ry = virtual spool reader address 

If the specified device is in use via diagnose, the VSPLCTL block is 
checked to see whether or not this is a repeated call for printer 
SFBLOKs. If it is, then the chain search continues from the point where 
the last SFBLOK was given to the virtual machine. In this case, cc = 1 
is set when there are no more print files. If this is the first call for 
an SFBLOK, or if there have been intervening calls for file reading, the 
spool input chain is searched from the beginning, and cc=2 is set if no 
files are found. 

Note: The virtual buffer specified via Rx must not cross a page boundary 
or a specification exception will result. 
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Subcode X'OOOS 1 

Rx = virtual address of a 12-doubleword buffer 
Ry = virtual spool reader address 

Processing for subcode X , 0008 l is the same as for subcode X'0004', 
except that only card-iaage input files are processed. 

Note: For both subcode X'OOOU 1 and subcode X»0008» # the format 
definition for a VM/370 SFBLOK can be found in the system macro library. 



suDCoae i.*wvi~* 

Rx = file identifier of requested file 
Ry = virtual spool reader address 

The spool input chain is searched for the file specified. If it is 
not found, cc=2 is set. If it is found, the file is moved to the head 
of the chain so that it will be the next file processed by any of the 
other functions. 



Subcode X'0010* 

Rx = new copy count for the active file 
Ry = virtual spool reader address 

The specified device is checked for an active file. If no file is 

active, cc=2 is set. Otherwise, the copy COUNT for the file is set to 

the specified value, with a maximum of 255. If the specified count is 

not positive, a specification exception is generated, if the count is 
greater than 255, it is adjusted to nodule 256. 



Subcode X«0014* 

Rx = start address of virtual fullpage buffer 
Ry = virtual spool reader address 

The specified device is checked for an active file. If no active file 
is found, cc=2 is set. Otherwise, the VSPLCTL pointers are reset to the 
beginning of the file. 



Subcode X'OOIS* 



Rx = start address of virtual fullpage buffer 
Ry = virtual spool reader address 
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The specified device is checked for an active file. If no active file 
is found, cc=2 is set. Otherwise, the file is backspaced one record and 
the record is given to the user as in subcode X'OOOO*. If the file is 
already positioned at the first record, the first record is given to the 



user. 



Subcode X'001C» 

Rx = virtual address of a 12-doubleword buffer 
Ry = virtual spool reader address 

Processing is the same as Subcode X'OOOS', except that only monitor 
spool files, as identified by the SFBMON flag is SFBFLAG2, can be 
handled. 



Subcode X , 0020» 

Rx = start address of fullpage virtual buffer 
Ry = virtual spool reader address 

Processing is the same as Subcode X'OOOO', except that only monitor 
spool files, as identified by the SFBMON flag in SFBFLAG2, can be 
handled. 



Subcode X»0FFF* 

Rx = virtual address of a 252-byte buffer 
Ry = spool file ID number 

If Ry is nonzero, the spool input chain is searched for a file with a 
matching ID number: If none is found or if one is found that is owned 
by a different virtual machine, cc=2 is set. The chain search is 
continued from the file that was found, or from the anchor if Ry is 
zero, for the next file owned by the caller, independent of file type, 
class, IHDSE flag, etc. If none is found, cc=1 is set. Otherwise, the 
SFBLOK and the first record of the file (generally, the TIG) are copied 
to the caller's virtual storage buffer. 



DIAGNOSE Code X.M 81 -- Standard DASD I/O 

Input/output operations to a direct access device, of the type used by 
CMS, can be performed from a virtual machine using DIAGNOSE code XM8 1 . 
No I/O interrupts are returned by CP to the virtual machine; the 
DIAGNOSE instruction is completed only when the READ or WRITE commands 
associated with the DIAGNOSE are completed. The Rx register contains 
the virtual device address of the direct access device. The Ry register 
contains the address of a chain of CCWs. The CCN chain must be in a 
standard format that CP expects when DIAGNOSE code X'18* is used, as 
shown below. Register 15 must be loaded by the user with the number of 
READs or WRITES in the CCW chain. 
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A typical CCW string to read or write two 800-byte records is as 
follows: 

SEEK, A, CC, 6 

SET SECTOR (not used for 2314/2319) 

SRCH,A*2,CC,5 

TIC,*-8,0,0 

RD or WRT, DATA, CC + SILI, 800 

SEEK HEAD,B,CC,6 (omitted if HEAD number unchanged) 

SET SECTOR 

SRCH,B+2,CC,5 

TIC,*-8,0,0 

RD or WRT,DATA+800,SILI,800 

A SEEK and SRCH arguments for first RD/WRT 
B SEEK and SRCH arguments for second RD/WRT 

The condition codes and completion codes returned are as follows: 

cc=0 I/O complete with no errors 

cc=1 Error condition- Register 15 contains one of the following: 

R15=1 Device not attached 

R15=2 Device not 2319, 2314, 3330, 3340, or 3350 

R15=3 Attempt to write on a read-only disk 

R15=4 Cylinder number not in range of user's disk 

R15=5 Virtual device is busy or has an interrupt pending 

cc=2 Error condition- Register 15 contains one of the following: 

R15=5 Pointer to CCW string not doubleword-aligned. 

R15=6 SEEK/SEARCH arguments not within range of user's 

storage 
R15=7 READ/WRITE CCW is neither Read (06) nor Write (05) 
R15=8 READ/WRITE byte count=0 
R15=9 READ/WRITE byte count greater than 2048 
R 15=10 READ/WRITE buffer not within user's storage 
R15=11 The value in R15, at entry, was not a positive number 

from 1 through 15, or was not large enough for the 

given CCW string - 
R 15=12 Cylinder number on seek head was not the same number as 

on the first seek. 

cc=3 Uncorrectable I/O error: 

R15=13 

CSW (8 bytes) returned to user 

Sense bytes are available if user issues a SENSE command 



D IAGNO SE Code X.MC^ -- Clea r Error Recording Cylinders 

Execution of DIAGNOSE code XMC 1 allows a user with privilege class P to 
clear the error recording data on disk- The DHKIOEFM routine performs 
the clear operation. The register specified as Rx contains a one-byte 
code value in the low- order byte as follows: 

Code Function 

X'OI 1 Clear and reformat all error recording, leaving any 

frame records intact 
X'02' Clear and reformat all error recording cylinders, erasing 

both frame records and error records 
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DIAGNOSE Code X'20 1 — General I/O 

With DIAGNOSE code X^O 1 , a virtual Machine user can specify any valid 
CCW chain to be perfomed on a tape or disk device. No I/O interrupts 
are reflected to the virtual Machine; the DIAGNOSE instruction is 
coMpleted only when all I/O coMMands in the specified CCW chain are 
finished. The register specified as Rx contains the virtual device 
address. The Ry register contains the address of the CCW chain. 

The CCWs are processed via DMKCCWTR through DHKGIOEX, providing full 
virtual I/O in a synchronous fashion (self-MOdif ying CCWs are not 
perMitted, however) to any virtual Machine specified. Control returns 
to the virtual Machine only after completion of the operation or 
detection of a fatal error condition. EREP support is provided for tape 
and DASD devices only; all other devices will present an error condition 
in the PSW to the virtual user. Condition codes and error codes are 
returned to the virtual system. 

The condition codes and error codes returned are as follows: 

cc=0 I/O coMpleted with no errors 

cc=1 Error condition. Register 15 contains the following: 

R15=1 Device is either not attached or the virtual channel is 

dedicated. 
R15=5 Virtual device is busy or has an interrupt pending. 

cc=2 Exception conditions. Register 15 contains one of the 
following: 

R15=2 Dnit exception bit in device status byte=1 
R15=3 Wrong length record detected. 

cc=3 Error Condition: 

R15=13 A permanent I/O error occurred or an unsupported device 
was specified. The two rightmost positions of the 
user's Ry register contain the first two sense bytes 



DI AGNO SE Code X1242. zz Device Type and Features 

DIAGNOSE code X'24 1 requests CP to provide a virtual Machine with 
identifying inforMation and status inforMation about a specified virtual 
device. The virtual Machine Must specify the virtual device for which 
inforMation is requested. CP returns inforMation about the virtual 
device and associated real device in the Rx, Ry, and Ry+1 registers. CP 
also provides a condition code identifying the specific device 
inforMation returned to the virtual Machine. 

When a virtual Machine issues DIAGNOSE code X^U', the Rx register 
Must contain the virtual device address for which inforMation is 
requested or the value negative 1 (-1). Specify -1 when the device is a 
virtual console whose address is unknown to the virtual Machine. 

When CP returns control to the virtual Machine, the Ry, Ry+1, and Rx 
registers contain device inforMation. The Ry register contains 
inforMation about the virtual device and the Ry+1 register inforMation 
about the real device. If -1 was specified and CP located the virtual 
console, the Rx register contains inforMation about the virtual console. 

CP obtains device inforMation froM three control blocks: virtual 
device inforMation f roM the virtual device block (VDEVBLOK) , and real 
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device information from the real device block (RDEVBLOK) and from 
HICBLOK. The following diagrams identify specific information returned 
by CP and show how to locate this information in the Rx, Ry # and Ry+1 
registers. The symbolic names used in these diagrams are the symbolic 
names used with VDEVBLOK, RDEVBLOK, and NICBLOK in VH/370 Data Areas and 
i Contro l Block Logic. 



| Rx Register 



r 

I Byte | 


Byte 1 


I Byte 


2 | Byte 3 | 


| RDEVTMCD | 
i ~ or *= { 
| NICTMCD | 
I I 




I 
I 


virtual | 

address j 
1 1 



I Symbol ic Ha me 

| RDEVTMCD 
! - or - 

| NICTMCD 
I 



Meaning 

Terminal code bits defining the type of console and 
the translate table the console is using. RDEVTMCD is 
for a local virtual console; NICTMCD for a remote 3270 
virtual console 



I Ry, Registe r 



I 



1 Byte J Byte 1 | Byte 2 | Byte 3 | 



I 1 

| VDEVTYPC | VDEVTYPE | VDEVSTAT | VDEVFLAG | 

i 1 



I Symbolic Name Meaning 

j VDEVTYPC Virtual device type class 

I VDEVTYPE Virtual device type 

I VDEVSTAT Virtual device status 

| VDEVFLAG Virtual device flags 

I Bv+1 Register 



I Byte 


1 Byte 1 


I Byte 2 | 


Byte 3 | 


| RDEVTYPC 


| RDEVTYPE 


| RDEVMDL | 


RDEVFTR | 




I - or - 


- or - I 


- or - j 




I HICDTYPE 
I I 


NICHDL | 
I 


RDEVLLEN | 
- or - | 




I 


I 


NICLLEN | 
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Symbol ic Name Meani ng 

RDEVTYPC Real device type class 

Real device type 

Real device model number 



RDEVTYPE 

RDEVHDL 

RDEVFTR 



Real device feature code for 
virtual console 



device other than a 



RDEVLLEN 
NICDTYPE 
NICMDL 

NICLLEN 



Current device line length for a local virtual console 

Real device type for a remote 3270 virtual console 

Real device model number for a remote 3270 virtual 
console 

Current device line length for a remote virtual console 



The following chart lists the condition codes CP can return for 
DIAGNOSE code X*24', the meaning of each condition code, and the 
registers where data is returned. 



r " ~ " m - ■- — 1 
I I This register | 1 
I 1 contains information | 1 


1 code eguals j Rx* | Ry | Ry*1 2 j Comments j 


I | X | X | X | Normal completion | 


I 1 III I Undefined | 


I 2 | X | x | | The virtual device | 
I till exists but is not asso- | 
I I j j j ciated with a real j 
I I I I I device I 


I 3 III I Invalid device address | 
I III I or the virtual device | 
I I I I I does not exist j 


I *The Rx register contains information only when DIAGNOSE code X'24' | 
I specifies a virtual console whose address in unknown. j 
| 2 If Ry is register 15, CP returns only virtual device information: no j 
| information is returned in register Ry+1. j 



DIAGNOSE Code X'28 1 -- Channel Program Modification 

DIAGNOSE code X'28* allows a virtual machine to correctly execute some 
channel programs modified after the Start I/O (SIO) instruction is 
issued and before the input/output operation is completed. The channel 
command word (CCW) modifications allowed are: 

• A Transfer in Channel (TIC) CCW modified to a No Operation (NOP) CCW 

• A TIC CCW modified to point to a new list of CCWs 

• A NOP modified to a TIC CCW 
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When a virtual Machine Modifies a TIC CCW, it is Modifying a virtual 
channel program. CP has already translated that channel prograi and is 
waiting to execute the real CCWs. The DIAGNOSE instruction, with code 
X'28', Must be issued to infora CP of the change in the virtual channel 
program, so that CP can Make the corresponding change to the real CCW 
before it is executed. In addition, when a HOP CCW is Modified to point 
to a new list of CCWs, CP translates the new CCWs. 

To be sure that the DIAGNOSE instruction is recognized in tiMe to 
update the real CCW chain, the virtual Machine issuing the DIAGNOSE 
instruction should have a high favored execution value and a low 
dispatching priority value. The CP SET command should be issued: 

SET FAVORED XX 

SET PRIORITY nn 

where xx has a high numeric value and nn has a low nuMeric value. The 
virtual Machine issuing the DIAGNOSE code X*28' Must be in the 
supervisor Mode at the tiMe it issues the DIAGNOSE instruction. 

When DIAGNOSE code X'28' is issued, the Rx register contains the 
address of the TIC or NOP CCW that was Modified by the virtual Machine. 
The Ry register contains the device address in bits 16 through 31. Rx 
and Ry cannot be the saMe register. . The addresses specified in the Rx 
register, the new address in the Modified TIC CCW, and the new CCW list 
to which the Modified TIC CCW points Must all be addresses that appear 
real to the virtual Machine: CP knows these addresses are virtual, but 
the virtual Machine thinks they are real. 

The condition codes (cc) and completion codes are as follows: 

cc=0 The real channel prograi was successfully Modified; register 
15 contains a zero. 

cc=1 There was probably an error in issuing the DIAGNOSE 
instruction. Register 15 (R15) contains one of the following 
completion codes: 

R15=1 The saie register was specified for Rx and Ry. 

R15-2 The device specified by the Ry register was not found. 

R15=3 The address specified by the Rx register was not within 

the user's storage space. 
R15=4 The address specified by the Rx register was not 

doubleword aligned. 
R15=5 A CCW string corresponding to the device (Ry) and 

address (Rx) specified was not found. 
R15=6 The CCW at the address specified by the Rx register is 

not a TIC nor a NOP, or the CCW in the channel prograi 

is not a TIC nor a NOP. 
R15=7 The new address in the Modified TIC CCW is not within 

the user's storage space. 
R15=8 The new address in the Modified TIC CCW is not 

doubleword aligned. 

cc=2 The real channel prograi cannot be Modified because a channel 
end or device end already occurred. Register 15 contains a 9. 
The virtual Machine should restart the Modified channel 
prograi. 
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DIAGNOSE Code X«2C -- Return DASD Start of LOGBEC 

Execution of DIAGNOSE code X^C allows a user with privilege class C, 
E, or F to find the location on the disk of the error recording area, 
the number of error recording cylinders, and the location of the first 
error record. 

The register specified as Rx contains a one-byte code in the 
low-order byte, indicating the function to be performed: 

X'01' - Return the DASD location of the start of the error recording 
area, and the number of error recording cylinders. 



X«02» - Return the 
record) . 



HDRSTART value (DASD location of first error 



X , 04* - Return indication of whether 
error recording cylinders. 

On return to the issuer of DIAGNOSE '2C»: 



there are frame records on the 



If code •01' is specified: Register Rx will contain the DASD 
location (in VM/370 control program internal format) of the start of 
the error recording area. Ry contains, in the low-order half word, 
the number of error recording cylinders. 

If code '02* is specified: Register Rx will contain the DASD 
location of the first error record (in CCPD format) . The value 
actually points to the last frame record written, or record 2 if no 
frame records present. 

If code •04* is specified: Register Ry will contain a X , 02' in the 
low-order byte if frame records are present on the error recording 
cylinders; X'00 1 if no frame records present. 

Note : Codes ' 02« and '04 1 may both be specified (code '06') on invoking 
DIAGNOSE. Both an Rx and Ry value must be specified. 



DIAGNOSE Code X'30 1 -- Read One Page of LOGREC Data 

Execution of DIAGNOSE code X'30' allows a user with privilege class C, 
E, or F to read one page of the system error recording area. The 
register specified as Rx contains the DASD location (in VM/370 control 
program internal format) of the desired record. The Ry register 
contains the virtual address of a page-size buffer to receive the data. 
The DHKRPAGT routine supplies the page of data. The condition codes 
returned are: 




Meaning 

Successful read, data available 

End of cylinder, no data 

I/O error 

Invalid cylinder, outside recording area 



DIAGNOSE Code I^3|P -- Read System Dump Spool File 

A user with privilege class C or E can read the system spool file by 
issuing a DIAGNOSE code X'34' instruction. The register specified as Rx 
contains the virtual address of a page- size buffer to receive the data. 
The Ry register, which must not be register 15, contains the virtual 
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address of the spool input card 
error codes as follows: 



reader. Ry*1, on return, may contain 



Condition 

Code 

q 


Ry+1 
Error Code 


1 




2 




3 


4 


3 


8 


3 


12 


3 


16 



Meaning 

Data transfer successful 

End of file 

File not found 

Device address invalid 

Device type invalid 

Device busy 

Fatal paging I/O error 

The DMKDRDMP routine searches the system chain of spool input files 
for the dump file belonging to the user issuing the DIAGNOSE 
instruction. The first (or next) record from the dump file is provided 

DKKRPAGT and the condition code is set to 






ne± m a 



zero. The dump file is closed via VM/370 console function CLOSE. 



DIAGNOSE Code X'38 1 ~ Read System Symbol Table 

Execution of DIAGNOSE code X«38« causes the routine DMKDRDSI to read the 
system table into storage. The register specified as Rx contains the 
address of the page buffer to contain the symbol table. 

DIAGNOSE Code X»3C ~ VM/370 Directory 

Execution of DIAGNOSE code X'3C* allows a user to dynamically update the 
VM/370 directory. The register specified as Rx contains the first 4 
bytes of the volume identification. The first two bytes of Ry contain 
the last 2 bytes of the volume identification. The routine DMKDDRDS 
dynamically updates the directory. 

DIAGNOSE Code X'4C — Generate Accounting Cards for the Virtual User 

This code can be issued only by a user with the account option (ACCT) in 
his directory. 

Rx contains the virtual address of either a 24-byte parameter list 
identifying the "charge to" user, or a variable length data area that is 
to be punched into the accounting card. The interpretation of the 
address is based on a hexadecimal code supplied in Ry. If the virtual 
address represents a parameter list, it must be doubleword aligned; if 
it represents a data area, the area must not cross a page boundary. If 
Rx is interpreted as pointing to a parameter list and the value in Rx is 
zeros, the accounting card is punched with the identification of the 
user issuing the DIAGNOSE instruction. 

Ry contains a hexadecimal code interpreted by DHKHVC as follows: 

Code Rx points to: 

0000 a parameter list containing only a userid. 

0004 a parameter list containing a userid and account number. 

0008 a parameter list containing a userid and distribution 

number. 
000C a parameter list containing a userid, account number, and 

distribution number. 
0010 a data area containing up to 70 bytes of user information to 

be transferred to the accounting card starting in column 

9. 
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Note: If Ry contains X'0010', Ry cannot be register 15. 

Ry*1 contains the length of the data area pointed to by Rx. If Rx 
points to a parameter list (Ry not equal to X'0010 1 ') , Ry+1 is ignored. 

DMKHVC checks the VHACCOON flag in VHPSTAT to verify that the user 
has the account option and if not, returns control to the user with a 
condition code of one. 

If Ry contains a code of X'0010', DHKH7C performs the following 
checks: 

9 If the address specified in Rx is negative or greater than the size 
of the user's virtual storage, an addressing exception is generated. 

• If the combination of the address in Rx and the length in Ry+1 
indicates that the data area crosses a page boundary, a specification 
exception is generated. 

• If the value in Ry*1 is zero, negative, or greater than 70, a 
specification exception is '^nerat*?'?- ; 

If both the virtual address and the length are valid, DHFBEE is 
called to obtain storage for an account buffer (ACHTBLOK) which is then 
initialized to blanks. The userid of the user issuing the DIAGHOSE 
instruction is placed in columns 1 through 8 and an accounting card 
identification code of "CO" is placed in columns 79 and 80. The user 
data pointed to by the address in Rx is moved to the accounting card 
starting at column 9 for a length egual to the value in Ry+1. A call to 
DMKACOQU queues the ACNTBLOK for real output. If a real punch is 
available, DHKACOPU is called to punch the card; otherwise, the buffer 
is stored in main storage until a punch is free. DMKHVC then returns 
control to the user with a condition code of zero. 

If Ry contains other than a X'0010' code, control is passed to DHKCPV 
to generate the card. DHKCPV passes control to DHKACO to complete the 
"charge to" information; either from the Oser Accounting Block 
(ACCTBLOK), if a pointer to it exists, or from the user's VHBLOK. 
DHKCPV then punches the card and passes control back to DHKHVC to 
release the storage for the ACCTBLOK, if one exists. DHKHVC then checks 
the parameter list address for the following conditions: 

• If zero, control is returned to the user with a condition code of 
zero. 

• If invalid, an addressing exception is generated. 

• If not aligned on a doubleword boundary, a specification exception is 
generated. 

For a parameter list address that is nonzero and valid, the userid in 
the parameter list is checked against the directory list and if not 
found, control is returned to the user with a condition code of two. If 
the function hexadecimal code is invalid, control is returned to the 
user with a condition code of three. If both userid and function 
hexadecimal code are valid, the User Accounting Block (ACCTBLOK) is 
built and the userid, account number, and distribution number are moved 
to the block from the parameter list or the User Hachine Block belonging 
to the userid in the parameter list. Control is then passed to the user 
with a condition code of zero. 
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DIAGNOSE Code X'SO* ~ Save the 370X Control Program Iiage 

DIAGNOSE code X*50' (Privilege class A, B, or C only) invokes the CP 
■odule DMKSNC to (1) validate the parameter list and (2) write the 
page-format image of the 370X control program to the appropriate system 
volume* 

When a 370X control program load module is created, the CHS service 
program SAVENCP builds a communications controller list (CCPARB) of 
control information- It passes this information to CP via a DIAGNOSE 
code X»50». 

The register specified as Rx contains the virtual address of the 
parameter list (CCPARB) . The Ry register is ignored on entry. 

Upon return, the Ry register contains the following error codes: 

Code Meaning 

044 ' ncpname* was not found in system name table. 

171 System volume specified not currently available. 

178 Insufficient space reserved for program and system control 

information. 

179 System volume specified is not a CP-owned volume. 
435 Paging error while writing saved system. 



D IAGNO SE Code X'54* -- Control The Function of the PA2 Function Key 

DIAGNOSE code X'54' controls the function of the PA2 function key. The 
PA2 function key can be used either to simulate an external interrupt to 
a virtual machine or to clear the output area of a display screen. 

The function performed depends upon how Rx is specified when DIAGNOSE 
code x'54* is issued. If Rx contains a nonzero value, the PA2 key 
simulates an external interrupt to the virtual machine. If Rx contains 
a value of zero, the PA2 key clears the output area of the display 
screen. 

The external interrupt is simulated only when the display screen is 
in the TM READ, HOLD, or MORE status and the TERMINAL APL ON command has 
been issued. 

DIAGNOSE Code X'58 1 ~ 3270 Virtual Console Interface 

Execution of DIAGNOSE code X'SS 1 allows a virtual machine to display 
large amounts of data on a 3270 in a very rapid fashion. The interface 
can display the entire 3270 screen with one write operation instead of 
22 writes (one for each line in the output area of a 3270 screen) . 

The register specified as Rx contains the address of the console CCW 
string. The Ry register contains (in bits 16 through 31) the device 
address of the virtual console. 

To specify the special display CCW, use the following assembler 
language instructions: 

DS 0D 

DC IM9S AL3 (dataddr), AL1 (flags), AL1(ctl), A L2 (count) 

where : 

dataddr is the beginning address of the data to be displayed. 
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flags is the standard CCW flag field with the suppress incorrect 
length indication (SLI) bit on. 

ctl is a control byte that indicates the starting output display 
line. If the high order bit is on, the entire 3270 output 
display area is erased before the nev data is displayed. A 
value of X'FF 1 clears the screen, but writes nothing. 

count is a two byte field indicating the number of bytes to be 
displayed. The maximum number of bytes for the 3278 Model 2A 
is 14U0. For other types it is 1760. 

When the DIAGNOSE is executed with a valid CCW string, a buffer 
(whose length is the number of bytes specified by count) is built in 
free storage. The data pointed to by dataddr is loaded into the buffer. 
Data chaining may be specified in the CCW to link noncontiguous data 
areas; however, command chaining is an end of data indication for the 
current buffer. 

Osing the starting output line (ctl) and the number of bytes of 
output (count), CP checks that the data will fit on the screen. CP then 
does the display. A zero condition code indicates the I/O operation 
completed successfully; a nonzero condition code indicates an I/O error 
occurred. 

Note ; An I/O error occurs when the display screen is placed in MORE 
status and the PA2 key is pressed to allow screen display. 



DIAGNOSE Code X^5C1: Error Message Editing 

Execution of DIAGNOSE code X'SC* causes the editing of an error message 
according to the user's setting of the EMSG function: 

Rx contains the address of the message to be edited. 

Ey contains the length of the message to be edited. 

DMKH7C tests the 7MMLEVEL field of the VMBLOK and returns to the caller 
with Rx and Ry modified as follows: 



| VMHLEVEL 


Registers 


■ -""i 

on Return I 


| VMMCODE 


fMMTEXT 


Rx 


I Ry I 


| ON 


ON 


no change 


no change | 


I ON 


OFF 


no change 


I 10 (length of | 
code) I 


| OFF 


ON 


pointer to text 
part of message 


I length of text | 
alone | 


| OFF | 


OFF 


N/A 




I 



Note: DIAGNOSE code x'SC 1 does not write the message; it merely 

rearranges the starting pointer and length. For CMS error messages, a 

console write is performed following the DIAGNOSE unless Ry is returned 
with a value of 0. 
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DIAGNOSE Code X M>0_^ - D etermini ng the Virtual Machine Storage Size 

Execution of DIAGNOSE code X'60* allows a virtual machine to determine 
its size. On return, the register specified as Rx contains the virtual 
machine storage size. 

DIAGNOSE Code X'64' - Fin ding. Loading , and Purging a Named Segment 

Execution of DIAGNOSE code X^U 1 controls the linkage of discontiguous 
saved segments. The type of linkage that is performed depends upon the 
function subcode in the register specified as Ry. 



Subcode 
X'OO 1 
X«04« 
X«08« 
X'OC 



Function 
LOADSYS — Loads a named segment in shared mode 
LOADSYS — Loads a named segment in nonshared mode 
PORGESYS — Releases the named segment from virtual storage 
FINDSYS — Finds the starting address of the named segment 



The register specified as Rx must contain the address of the name of 
the segment. The segment name must be 3 bytes long, left justified, and 
padded with trailing blanks. 



The LOADSYS Function 



When the LOADSYS diagnose function is executed, CP finds the system name 
table entry for the named system and builds the necessary page and swap 
tables. Two sets of page and swap tables, one for each processor, are 
built for each shared segment in attached processor mode unless the 
named system was defined as unprotected. CP releases all the virtual 
pages of storage that are to contain the named segment and then loads 
the segment in those virtual pages. When the LOADSYS function is 
executed, CP expands the virtual machine size dynamically, if necessary. 
CP also expands the segment tables to match any expansion of virtual 
storage^ 

When LOADSYS executes successfully, the address of where the named 
segment was loaded is returned in the register specified as Rx. When 
the LOADSYS function loads a segment in shared mode, it resets 
instruction and branch tracing if either was active. 

After a LOADSYS function executes, the storage occupied by the named 
segment is addressable by the virtual machine, even if that storage is 
beyond the storage defined for the virtual machine. However, any 
storage beyond that defined for the virtual machine and below that 
defined for the named segment is not addressable. Figure 15 shows the 
virtual storage that is addressable before and after the LOADSYS 
function executes. 
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Before the LOADSYS 
Function Executes 



After LOADSYS Function 
Executes 
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CMS Virtual Machine with 
a Naaed Segaent Attached 



Figure 15. Addressable Storage Before and After a LOADS YS Function 



When you save a naaed segaent that is later loaded by the LOADSYS 
function, you Bust be sure that the addresses at which segaents are 
saved are correct and that they do not overlay required areas of storage 
in the virtual aachine. This is crucial because the LOADSYS function 
invokes the PORGESYS function before it builds the new page and swap 
tables. CP purges all saved systeas that are overlayed in any way by 
the saved systea it is loading. 

A condition code of in the PSW indicates that the naaed segaent was 
loaded successfully; the Rx register contains the load address. 

A condition code of 1 in the PSW indicates the naaed segaent was 
loaded successfully within the defined storage of the virtual aachine. 
The Rx register contains the address at which the naaed segaent was 
loaded. The Ry register contains the ending address of the storage 
released before the naaed segaent was loaded. 



Note : CHS only allows naaed segaents to be attached 
size of the virtual aachine. 



beyond the defined 



A condition code of 2 in the PSW indicates the LOADSYS function did 
not execute successfully. Exaaine the return code in the Ry register to 
deteraine the cause of the error. 



R etur n Code Meaning 

44 Naaed segaent does not exist 
177 Paging I/O errors 



The PORGESYS Function 



When the PORGESYS function is executed; CP releases the storage, and 
associated page and swap tables, that were acquired when the 
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corresponding LOADSYS function vas executed. If the storage occupied by 
the named segment vas beyond the defined virtual machine storage size, 
that storage is no longer addressable by the virtual machine. 

When a PURGESYS function is executed for a segment that vas loaded in 
nonshared mode, the storage area is cleared to binary zeros. If 
PURGESYS is invoked for a named segment that vas not previously loaded 
via LOADSYS, the request is ignored. 

A condition code of in the PSW indicates successful completion. 

A condition code of 1 in the PSW indicates that the named segment vas 
not found in the virtual machine. 

A condition code of 2 in the PSW and a return code of 44 in the Ry 
register indicate that the named segment either does not exist or vas 
not previously loaded via the LOADSYS function. 



The FIN DSYS Function 

When the FINDSYS function is executed, CP checks that the named segment 
exists and that it has not been loaded previously. 

A condition code of in the PSW indicates that the named segment is 
already loaded. The address at vhich it vas loaded is returned in the 
register specified as Rx and its highest address is returned in the Ry 
register. 

A condition code of 1 in the PSW indicates that the named segment 
exists but has not been loaded. In this case, the address at vhich the 
named segment is to be loaded is returned in the register specified as 
Rx and the highest address of the named segment is returned in the Ry 
register. 

A condition code of 2 in the PSW indicates the FIHDSYS function did 
not execute successfully. Examine the return code in the Ry register to 
determine the error that occurred. 

R A +•«»"»•« f* *\A *% H A-k n4 vt*v 

44 Named segment does not exist 
177 Paging I/O errors 



DIAGHOSE Code X'6 8* -- Virtual Machine Communication Facility (VMCF) 

The DIAGNOSE code X'68 1 is used by a virtual machine to initiate a 
subfunction of the Virtual Machine Communication Facility (VMCF) . The 
general register specified as Rx contains the virtual address, 
doublevord aligned, of a parameter list (VHCPARH) . One of the entries 
in this parameter list is a subfunction code, specifying the particular 
request being initiated. The subf unctions and their codes are: 
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Subfun ctign 

AOTHORIZE 

UNAUTHORIZE 

SEND 

SEND/RECV 

SEHDX 

RECEIVE 

CANCEL 

REPLY 

QOIESCE 

RESUME 

IDENTIFY 

REJECT 



Code 
X'0000 1 
X'OOOV 
X'0002» 

x'oooa' 
x f oooa« 

X'0005» 
X»0006« 
X»0007' 

x^os' 

X«0009« 
X«OOOA» 
X'OOOB* 



A description of all the fields of the VHCPARM is contained in the 
VM/370 System P rogrammer's Guide. 

The general register specified as Ry will contain the return code 

upon completion of DIAGNOSE X'68 1 or the detection of an error 

<?ondi.t !*>!»* Th<* retnrn code*? are contained in the VM/370 System 
Programmer's Guide. 



Rx and Ry can be any general register, RO through R15, 
be the same register. 



They may also 



I DIAGNOSE Code X ' 7 jP -- Load 3800 Named System Into Virtual Storage 

DIAGNOSE code X'74 1 allows a virtual machine to load a 3800 named system 
into virtual storage beginning at a specified virtual address and to 
take a copy of an image library and save it in a specified named system. 
A named system is one that contains 3800 character arrangement tables, 
copy modifications, and file control blocks (FCBs) . These can be 
referenced by name, and the data can be obtained when the file 
referencing them is about to print on a 3800 printer. The new data in 
the named system is used to load into the 3800 the next time NAMED 
SYSTEM is specified as the IMAGELIB parameter in a START command for a 
3800 printer. 

At system generation time, the NAME3800 macro instruction establishes 
the name of the 3800 system in the DMKSNT module. The active named 
system for a particular 3800 printer will be in its RDEVBLOK. 

The GENIHAGE command creates the image library in virtual storage. 
This is done by interfacing with the OS IEBIHAGE utility program 
(DMKIHG) . The IMAGELIB command saves the image library and issues the 
DIAGNOSE code X'74 1 to establish the named system. 

When using DIAGNOSE code X'74 1 , the registers specified by the user 
as Rx and Rx+1 must contain the eight-character name of the system 
desired, left- justified and padded with trailing blanks. 

The register specified by the user as Ry must contain the virtual 
address at which to start loading or saving the storage image of an 
image library. 

The register specified by the user as Ry+1 must contain a one-byte 
code in the high-order byte indicating the function to be performed as 
follows: 

X'00' - LOAD operation 
X'Qip - SAVE operation 
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i The low-order bytes of register Ry+1 must contain the number of bytes to 

I load or save. 

| If either Rx or Ry is specified as register 15, or if the virtual 

| address specified in Ry is not on a page boundary, a specification 

I exception results and the program terminates. 

| An addressing exception results if the end of the area to be loaded 

| or saved extends beyond the end of the user's virtual storage. A 

| privileged operation results if the user does not have privileged class 

I A, B, or C. 

I Register Ry contains a return code upon completion of processing as 

| follows: 



I Condition 



Kean i ng 



I X*00' Load or save successfully performed 

I X'04 1 Named system not found 

I X'OS 1 Named system currently active 

I X'OC* Volid for system not CP-owned 

I X'10* 7olid for system not mounted 

j X'14' Too many bytes to load or save. Residual Byte 

I count is in register Ry*1 

I XM8' Paging error during load or save 



I DIAGNOSE Code X*78* -- HSS Support 

DIAGNOSE code l'lS f is used to communicate between a virtual machine and 
CP for HSS support. A subf unction code is placed in the Ry register. 
The specific subfunction codes and their meanings are: 

Subfunction 

Code Meaning 

X'OO 1 The virtual machine is running OS/VS with HSS 

support and is now ready to communicate with both 
VH/370 and the mass storage control (HSC) . The 
Rx field of the instruction contains the number 
of a register that contains the virtual device 
address of the HSS communication device. 

X'04* The virtual machine is ready to process an HSS 
reguest. The reguest, in the form of an HSSCOH 
control block, is to be placed at the virtual 
machine address indicated by the register in the 
Rx field of the instruction. 

X'OS 1 The HSS reguest, in the form of an HSSCOH control 
block, located at the virtual machine address 
contained in register Rx, has been processed by 
the HSC. 

XMO* The virtual machine is no longer able to process 
HSS requests. 
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I DIAGNOSE Code XMJU^ ~~ Directory Update In-Place 



DIAGNOSE code X'84' can be used to make changes to the online directory 
if the change causes no expansion to the entry and vhen the user wants 
the change to go into effect immediately. This interface is provided 
for the privilege class B virtual machine that owns the directory. 
Yalidity checking is performed on update parameters and the specified 
user's directory is updated in storage and written on the current DASD 
copy. If any errors are encountered, either in specifications or in 
DASD I/O, the update in-place is not performed and an error condition is 
passed to the invoking virtual machine. 

General register Rx points to a variable length parameter list. 
Register Ry contains the length of the parameter list, in bytes. The 
parameter list contains fixed common fields and variable fields as shown 
below: 

Field Name F uncti on 

Common ODSERID Dserid to be updated 

nr>rtrtTt ■» «?«■ r> ., -^ — ^ ~ *. 1 *■>„,->,» -n- _„,j,^,-,a 

OOP Update operation to perform 
UCMMONSZ Length of common fields 

Variable UNEWPASS New logon password 

USTORAGE New storage size 

UPRI7 Up to eight privilege classes 

UPRIOR New priority (a number between and 99) 

UEDITCH Edit characters (LE, LD, CD, ES) 

UIPL New IPL name 

UACCOUNT New account data 

UDISTRIB New distribution data 

UMDISKAD New minidisk address 

UMDISKMD New minidisk link mode 

UMDISKRP New minidisk read password 

UMDISKWP New minidisk write password 

UHDISKMP New minidisk multiple password 

UOPTIONS Up to 9 options 

The variable field chosen is positioned after the UOP field. Only one 
variable field can be used at one time. A separate DIAGNOSE code X'84' 
must be issued for each variable function desired. 

If any errors are found, the condition code is set to 1 and register 
Ry may contain one of the following codes: 

Return 

Code Meaning 

10 Error in DMKRPAPT when writing object DASD 

11 Error in DMKRPAPT when writing paging DASD 

20 Error during 'TRANS* of UDIR page 

21 No UMAC address in UCNTRL 

22 Error during 'TRANS' of UMAC page 

23 No UDE? address in UCNTRL 

24 No UDE? address in UCNTRL 

25 Error during 'TRANS' of UDEV page 

26 UDET block not found 

27 Object DASD not synchronous with DMKSISPL 

28 Operation invalid 

30 Userid not found 

31 Logon password mismatch 

40 Storage exceeds maximum allowed 

41 Maximum storage greater than 16M 

42 No sign after packing new size 
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Meaning 

Invalid bytes in storage data 

50 Privilege operand all blanks 

51 No valid privilege classes in operand 

52 Error in accumulated privilege value 

53 Invalid data in privilege field 

60 Invalid data in priority field 

61 Priority field all blanks 

62 No sign after packing new priority 

63 Priority greater than maximum 

70 Invalid option 

71 No fence of X'FF's at end of parameter list 

72 Invalid accumulated option values, signifying an 

option error 

80 Invalid MDISK address in parameter list 

81 Invalid link mode 

If no errors are found, the condition code is set to zero. 



I/O Interruption 

I/O interruptions from completed I/O operations initiate various 
completion routines and the scheduling of further I/O requests. The I/O 
interruption handling routine also gathers device sense information. 



Machine Check Interruption 

When a machine check occurs, CP Recovery Management Support (RMS) gains 
control to save data associated with the failure for FE maintenance. 
RMS analyzes the failure and determines the extent of damage. 

Damage assessment results in one or more of the following actions 
being taken: 

• System termination 

• Attached processor varied offline (system converts to uniprocessor 
mode) 

• Virtual user running at the time of error is terminated 

• Refreshing of damaged information with no effect on system 
configuration 

• Refreshing of damaged information with the defective storage page 
removed from further system use 

• Error recording only for certain soft machine checks 

The system operator is informed of all actions taken by the RHS 
routines. When a machine check occurs during YH/370 startup (before the 
system is set up well enough to permit RMS to operate successfully) , the 
processor goes into a disabled wait state and places a completion code 
of X'OOB 1 in the leftmost bytes of the current PSW. 
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SVC Interruption 

When an SVC interruption occurs, the SVC interruption routine (DMKSVCIN) 
is entered. If the machine is in the problem state, DMKSVCIN takes the 
following action: 

• If the interruption was the result of an ADSTOP (SVC code X'B3'), the 
■essage ADSTOP AT XXXXX is sent to the user's terminal, the overlaid 
instruction is replaced, and the virtual machine is placed in console 
function mode (CP mode) via DMKCFMBK. 

• If the interruption was the result of an error recording interface 
(SVC 76) , DHKSVC checks for valid parameters and passes control to 
DMKVER to convert virtual device addresses in the error record to 
real device addresses. The actual recording is accomplished in 
DMKIOE and DMKIOF. If recording is not possible, the interrupt is 
reflected back to the virtual machine. 

• If the virtual machine's page was not in real storage, then all 
general and floating-point registers are saved, the user's VMBLOK is 
flagged as being in an instruction wait, and control is transferred 
(via GOTO) to DMKPRGRF to reflect the interruption to the virtual 

machine. 

• If the virtual machine's page is in main storage, an appropriate 
SVC old PSW is stored in the user's page and the interruption is 
reflected to the virtual machine, bypassing unnecessary register 
saving (fast reflection) . If the new virtual PSW indicates a mode or 
enablement change, all registers are saved in the VMBLOK and control 
is transferred to DMKDSPB for PSW validation. 

If the machine is in the supervisor state, the SVC interruption code 
is determined and a branch is taken to the appropriate SVC interruption 
handler. 

SVC 

Impossible condition or terminal error. The SVCDIE routine initiates an 

abnormal termination by using the DHKDHPDK routine. 

SVC 4 

Reserved for IBM use. 

SVC 8 

A link request that transfers control from the calling routine to the 
routine specified by register 15. The SVCLINK routine sets up a new 
save area, and then saves the caller's base register in register 12 and 
save area address in register 13, and the return address (from the 
SVCOPSW) in the new save area. If the called routine is within the 
resident CP nucleus, SVCLINK places its address in register 12 and 
branches directly to the called routine. If the called routine is in a 
pageable module, a TRANS macro is performed for register 12 to ensure 
that the page containing the called routine is in storage, upon return 
from the TRANS execution, the real address of the pageable routine is 
placed in register 12 and SVCLINK branches to the called routine. The 
real storage location of DMKCPE is the end of the resident CP nucleus. 
Any modules loaded at a higher real storage address are defined as 
pageable modules. If bit zero of register 15 is on when DHKSVC is 
entered, then the caller has requested AFFINITY. DHKSVC turns on a bit 
in the save area passed to the caller to indicate that control is to be 
returned to the caller on the same processor on which it was running 
before issuing the SVC. It is not ensured that control will be retained 
by the initiating processor throughout the called operation, but only 
that final return will occur on the initiating processor. 
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SVC 12 

A return request that transfers control from the called routine to the 
calling routine). The SVCRET routine is invoked. If the routine that 
issued the S¥C 12 is pageable, then DMKPTRUL is called to unlock the 
page. SVCRET then restores registers 12 and 13 (addressability and save 
area address saved by SVCLINK) , places the user's return address (also 
saved in this area) baek into the SVCOPSW, and returns control to the 
calling routine by loading the SVCOPSW. 

SVC 16 

Releases current save area from the active chain (removes linkage 
pointers to the calling routine) . The SVCRLSE routine releases the 
current save area by placing the address of the next higher save area in 
register 13 and returns control to the current routine by loading the 
SVCOPSW. This SVC is used by second level interrupt handlers to bypass 
returning the first- level handler under specific ci re un stances. The 
base address field (register 12) in the save area being released is 
examined to determine if the bypassed routine is in a pageable module* 
If so, DMKPTROL is called to unlock the page. 

SVC 20 

Obtain a new save area. The SVCGET routine places the address of the 
next available save area in register 13 and the address of the previous 
save area in the save area pointer field of the current save area. 

SVC 24 

In attached processor mode, SVC 24 causes the instructions following the 
SVC to be executed by the main processor. This SVC is used only via the 
SWITCH macro to force processing to continue on the main processor (the 
processor capable of performing I/O) • If the SWITCH macro determines 
that the code is currently running on the main processor then the SVC is 
not issued. 

There are 35 save areas initially set up by DMKCPIHT for use by the 
SVC linkage handlers. If all the save areas are used, the linkage 
handlers call DMKFREE to obtain additional save areas. 
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External Interruption 

TIHER INTERRUPTION 

If DHKPSAEX is entered because of a timer interruption, the state of the 
■achine must be determined. If the machine was in wait state, control 
is transferred to DHKDSPCH, and the machine stays idle until another 
interruption occurs. If the machine is in problem state, the address of 
the current user's VHBLOK is obtained from RUNOSER. The user's current 
PSW (VHPSH) is updated from the external interruption old PSW, the 
address of the current VHBLOK is placed in register 11, and control is 
transferred to DHKDSPCH. For additional information about timers, see 
"Virtual Timer Maintenance." 

EXTERNAL INTERRUPTION 

If DHKPSAEX is sntsrsd because tue opera Lgi: pressed the console 
interrupt button (INTERRUPT), a CPEXBLOK is stacked to do the following: 

• Reference the current system operator's VHBLOK (DHKSYSOP) . 

• Disconnect this virtual machine. 

The operator can now log on from another terminal. Pressing the 
console interrupt button activates an alternate operator's console. 

Note ; If this interrupt comes from the attached processor, it is 
ignored. 

For a description of the processing of the external interruption 
command, refer to module DHKCPB in Section 2. 

See "Hultiprocessor External Interrupts" for a discussion of external 
interrupts that occur in attached processor mode. 

EXTENDED VIRTUAL EXTERNAL INTERRUPTIONS 

To reflect external interruptions to a virtual machine, DHKDSPE queues 
an XINTBLOK on a chain pointed to by VHPXINT in the VHBLOK. The 
XINTBLOKs are chained sequentially by the XINTSORT field that contains 
the collating number of the pending interruption. If more than one 
interruption has the same collating number, the interruption codes are 
ORed together in the XINTCODS field for possible simultaneous 
reflection. 

When a virtual machine is enabled for external interruptions, the 
XINTBLOK queue for that machine is searched for an eligible block. An 
XINTBLOK is eligible for reflection if one or more bits of the XINTHASK 
field match the bits in the rightmost half word of control register 0. 
If the interruption was an interruption such as CPU timer or clock 
comparator, the block is left chained because reflection does not reset 
these interruptions. If the reflected interruption (s) does not 
represent all those coded in the XINTHASK field, the block is left 
chained and only the interruptions that were reflected are reset. In 
all other conditions, the XINTBLOK is unchained and returned to free 
storage. 
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A special external interrupt, code X'UOOI* notifies a virtual machine 
of a pending ¥irtual Machine Communication Facility request. The 
XINTBLOK for this interrupt is set up with an XINTSORT field of 
X'7FFFFFFF f , the lowest priority. 



System Support 

FREE STORAGE MANAGEMENT 

During its execution, CP occasionally requires small blocks of storage 
that are used for the duration of a task. CP obtains this storage from 
the free storage area. The free storage area is divided into various 
size subpools. The requester informs the free storage manager of the 
size of the block required and the smallest available subpool that 
fulfills the request is allocated to the requester. When the block is 
no longer needed, the requester informs the free storage manager and CP 
returns the block to free storage. 

If the request for free storage cannot be fulfilled, the free storage 
manager requests the temporary use of a page of storage from the dynamic 
paging area. If a page is obtained, the page is chained to the free 
storage area and used for that purpose until it is no longer needed and 
subsequently returned to the dynamic paging area. 

If the request for a page cannot be fulfilled, the requester waits 
until free storage becomes available. 

STORAGE PROTECTION 

VM/370 provides both fetch and store protection for real storage. The 
contents of real storage are protected from destruction or misuse caused 
by erroneous or unauthorized storing of fetching by the program. 
Storage is protected from improper storing or from both improper storing 
and fetching, but not from improper fetching alone. 

When the processor accesses storage, and protection applies, the 
protection key of the current PSW is used as the comparand. The 
protection key of the processor is bit positions 8-11 of the PSW. 

If the processor access is prohibited because of a protection 
violation, the operation is suppressed or terminated, and a program 
interruption for a protection exception takes place. 

When the reference is made to a channel, and protection applies, the 
protection key associated with the I/O operation is used as the 
comparand. The protection key for an I/O operation is in bit positions 
0-3 of the CAW and is recorded in bit positions 0-3 of the CSW stored as 
a result of an I/O operation. If channel access is prohibited, the CSW 
stored as a result of the operation indicates a protection-check 
condition. 

When a storage access is prohibited because of a store protection 
violation, the contents of the protected location remain unchanged. If 
a fetch protection violation occurs, the protected information is not 
loaded into an addressable register, moved to another storage location, 
or provided to an I/O device. 
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To use fetch protection, a virtual machine must execute the set 
storage key (SSK) instruction referring to the data areas to be 
protected, with the fetch protect bit in the key. VH/370 subsequently: 

1. Checks for a fetch protection violation when handling privileged 
and nonprivileged instructions. 

2. Saves and restores the fetch protection bit (in the virtual storage 
key) when writing and recovering virtual machine pages from the 
paging device. 

3. Checks for a fetch protection violation on a write CCW (except for 
spooling or console devices) . 

A special case of storage protection occurs when the CMS nucleus 
resides in a protected shared segment. The CHS nucleus may be protected 
and still be shared by many CHS users. After a virtual machine has used 
a protected shared segment, the pages are checked for changes. If any 
pages have been changed, the user gets placed in console function mode 
after receiving error aessage PMKVMiii56W,- and the changed page is 
returned to CP free storage. 

EXECUTING THE PAGEABLE CONTROL PROGRAH 

Calls to pageable routines are recognized at execution time by the SVC 8 
linkage manager in DHKSVC. For every SVC 8, the called address (in the 
caller's GPR15) is tested to see if it is within the resident nucleus. 
If it is less than DHKCPEND and greater than DHKSLC, the called 
routine's base address is placed in GPR12 and control is passed to the 
called routine in the normal way. However, if the called address is 
above DHKCPEND or below DHKSLC, the linkage manager issues a TRANS 
macro, requesting the paging manager to locate and, if necessary, 
page- in the called routine. The TRANS is issued with LOCK option. 
Thus, the lock count associated with the called routine's real page 
indicates the responsibility count of the module. 

• When the module is called, the count is incremented. 

• When the routine exits via SVC 12, the count is decremented. 

When the count reaches zero, the pageable routine is unlocked and is 
eligible to be paged out of the system. However, because all CP 
pageable modules are reenterable, the page is never swapped out, but 
when the page is stolen, it is placed directly on the free page list. 

Because unlocked pageable routines participate in the paging process 
in a manner similar to user virtual storage pages, the least recently 
used approximation used by page selection tends to make highly used 
control program routines, even when not locked, remain resident. The 
called routine is locked into real storage until it exits. Thus, it can 
request asynchronously scheduled function, such as I/O or timer 
interrupts, as long as it dynamically establishes the interruption 
return address for the requested operation and does not give up control 
via an EXIT macro prior to receiving the requested interruption. 

Addressability for the module, while it is executing, is guaranteed 
because the CALL linkage loads the real address of the paged module into 
GPR12 (the module base register) prior to passing control. If all 
addressing is done in a base/displacement form, the fact that the module 
is executing at an address different from that at which it was loaded is 
not apparent. Although part of CP is pageable, it never runs in 
relocate mode. Thus, the processor is not degraded by the DAT feature 
being active, and no problems occur because of handling disabled page 
faults. 
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SYSTEM SUPPORT MODULES 

The system support modules provide CP with several common functions for 
data conversion and control block scanning and verification. Host of 
the routines are linked to via the BALR option of the CALL macro* and 
make use use of the BALRSA7E and TEMPSA7E workareas in DHKPSA. Two 
exceptions are the virtual and real I/O control block scan routines 
DMKSCNVU and DMKSCNRU- These routines do not alter the contents of the 
BALRSAVE area, and hence may be called by another low-level BALR 
routine. 



CONTROL REGISTER USAGE 

Every IBM System/370 processor provides the program with 16 logical 
control registers (logical registers since the number that are active 
depends on the features installed in the machine at any one time) that 
are addressable for loading and storing from basic control (BC) mode. 
VM/370 provides only a single control register, control register zero, 
for normal virtual machines, and for processing systems that do not 
require the full set of registers (for example, CMS, DOS, or other 
operating systems for System/360) . 

Any user whose virtual machine operating system requires the use of 
control registers other than control register zero, can request the full 
set of 16 registers by specifying the ECMODE option in the VH/370 
directory entry for his virtual machine. 

A virtual machine, which utilizes any System/370 features that use 
the control registers, requires the ECMODE option. Some of these 
features are expanded timer support of the System/370 CPU timer, clock 
comparator, etc., the virtual relocate mode and its instructions, RRB, 
LRA, PTLB, virtual monitor calls, virtual Program Event Recording (PER) , 
etc. 



RESTRICTIONS AND CONVENTIONS FOR PAGEABLE CP MODULES 

Pageable CP modules must observe the following restrictions and 
conventions when they are designed and coded: 

• The module must be entered by the standard SVC 8 CALL linkage. 
Modules entered by BALR or GOTO cannot be pageable. The module must 
return to its caller by SVC also. 

• The module cannot contain any A- or V-type address constants that 
point to locations within itself or within other pageable modules, 
and it cannot contain any CCWs that contain data addresses within 
themselves. The only exceptions are address constant literals 
generated as the result of calls to other modules (because these 
addresses are dynamically relocated at execution time, they must be 
resolved by the loader to the loaded address of the called module) 
and a pageable module that locks itself into storage. In practice, 
this restriction means that data or instructions within the pageable 
routine must be referenced via base/displacement addressing, and the 
address in register 15 for a CALL may not be generated by a LOAD 
ADDRESS instruction. 

• The pageable module must be no more than 4096 bytes in length. 



CP Introduction 1-79 



If the three above design and coding restrictions are adhered to, the 
CF module can be added to the existing pageable nucleus modules by 
utilizing the service routine, VMFLOAD, vhich is described in "VM/370 
Maintenance Procedures" of the VM/370 Service Routines Program Logi c. 
Additional information can be found in the~VM/370 Plan ning and System 
Generation Guide. ~ 

Executable Resident Modules 



DMKBSC 
DMKCCH 
DMKCCW 
DMKCFM 
DMKCHS 
DMKCVT 
DMKDAS 
DMKDGD 
DMKDMP 
DMKDSB 
DMKDSP 
DMKEXT 
DMKFRE 



DMKGRF 
DMKGRT 
DMKHVC 
DMKIOE 
DMKIOS 
DMKLOC 
DMKLOK 
DMKMCH 
DMKMCT 
DMKMSH 
DMKOPR 
DMKPAG 
DMKPGT 



DMKPRG 
DMKPRV 
DMKPSA 
DMKPTR 
DMKQCN 
DMKRGA 
DMKRGB 
DMKRNH 
DMKRPA 
DMKRSP 
DMKSCH 
DMKSCH 



DMKSSS 
DMKSTK 
DMKSVC 
DMKTMR 
DMKTRK 
DMKONT 
DMKVAT 
DMKVCN 
DMKVIO 
DMK7BA 
DMKVSI 
DMKVSP 



Executable Pacjeable Modules 



DMKACO 
DMKALG 
DMKAPI 
DMKATS 
DMKBLD 
DMKCDB 
DMKCDM 
DMKCDS 
DMKCFC 
DMKCFD 
DMKCFG 
DMKCFH 
DMKCFO 
DMKCFP 
DMKCFS 
DMKCFT 
DMKCKP 
DMKCKS 
DHKCLK 



DMKCPB 
DMKCPI 
DMKCPS 
DMKCPD 
DMKCPV 
DMKCQG 
DMKCQH 
DMKCQP 
DMKCQR 
DMKCQY 
DHKCSB 
DMKCSO 
DMKCSP 
DMKCSQ 
DMKCST 
DMKCSO 
DMKCSV 
DMKDEF 
DMKDIA 



DMKDIB 
DMKDRD 
DHKEIG 
DMKERM 
DMKGIO 
DMKHVD 
DMKIOC 
DMKIOF 
DHKIOG 
DHKISM 
DMKJRL 
DMKLNK 
DMKLOG 
DMKLOH 
DHKMCC 
DMKMID 
DMKMHI 
DMKMON 
DMKMSG 



Figure 16. Executable Modules 



DATA AREA MODULES 



DMKNEM 
DMKNES 
DMKHET 
DMKHLD 
DMKHLE 
DMKPGS 
DMKRSE 
DMKSAV 
DHKSEP 
DMKSEV 
DMKSIX 
DMKSHC 
DMKSPL 
DMKTAP 
| DMKTCS 
DMKTDK 
DHKTHI 
DHKTRA 



DMKTRC 
DMKTRD 
DMKTRM 
DMKODR 
| DMKODD 
DMKDSO 
DMKVCA 
DMKVCH 
DMKVDA 
DMKVDC 
DHKVDD 
DMKVDE 
DMKVDR 
DHKVDS 
DMKVER 
DMKVMC 
DMKVMI 
DMKWRH 



In addition to the executable resident and pageable modules (see Figure 
16), there are certain modules that only contain data areas and do not 
contain executable code. These modules are: 



Resident 
Mo dule 
DMKCPE 
! DMKGRW 
DHKRIO 
DMKSYS 
DMKTBL 



Contents 

Defines the end of the CP nucleus 

CCW*s and data for 3278 model 2A 

I/O device blocks 

System constants 

Terminal translate table 
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Pageable 

Module Contents 

DMKBOX Output separator table 

DMKBTS Bootstrap routines for 3705 

DHKEMA Error message data nodule 

DMKEMB Error message data module 

DHKEMC Error message data module 

DMKFCB 3203 and 3211 Forms Control Buffer (FCB) load tables 

DMKSNT System name table 

DMKSYM System symbol table 

DMKUCB 3211 Universal Character Set Buffer (DCSB) load tables 

DMKOCS 1403 Universal Character Set (UCS) load tables 

DMKTBM Terminal translate tables 

DMKVCC 3203 Universal Character Set Buffer (UCSB) load tables 

VIRTUAL TIMER MAINTENANCE 

The System/370 with EC mode provides the system user (both real and 
virtual) with four timing facilities. They are: 

• The interval timer at main storage location X^O' 

• The time-of-day clock 

• The time-of-day clock comparator 

• The CPU timer 



Real Timing Facilities 

Before describing how CP maintains these timers for virtual machines, it 
is necessary to review how VM/370 uses the timing facilities of the real 
machine. 

1. The location X'50 1 interval timer is used only for time-slicing. 
The value placed in the timer is the maximum length of time that 
the dispatched virtual machine is allowed to execute. 

Because the BLIP function of CMS uses the interval timer (location 



X'50*), the use of 5TIMER 


can cause extra blips at the user's 


terminal. To avoid extra 


blips, issue the CMS command SET BLIP 


OFF. 





2. The time-of-day clock is used as a time stamp for messages and 
enables the scheduler to compute elapsed in-gueue time for the 
dispatching priority calculation. 

3. The time-of-day clock comparator facility is used by CP to schedule 
timer-driven events for both control program functions and for 
virtual machines. A stack of comparator reguests is maintained and 
as clock comparator interrupts occur, the timer reguest blocks are 
stacked for the dispatcher via calls to DHKSTKIO. 

«*. The processor timer facility performs three functions: 

• Accumulates CP overhead 

• Detects in-gueue time slice end 

• Simulates virtual processor timer 

The accumulation of CP overhead is accomplished as follows. The 
VMTTIME field in the VMBLOK contains the total CP overhead incurred 
by the virtual machine; it is initialized to the maximum positive 
number in a doubleword, X^FFFFFFF FFFFFFFF 1 . Whenever CP performs 
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a service for a virtual Machine, GR 11 is loaded with the address 
of the VHBLOK and the current value in VHTTIHE is placed in the 
processor timer. When CP is finished with the service for that 
virtual Machine the processor timer, which has been decremented by 
the anount of processor time used, is stored back into VHTTIME. GB 
11 is then loaded with a new VMBLOK pointer and the processor timer 
is set from the new VHTTIME field. The amount of CP overhead for a 
given virtual machine at any point in time is the difference 
between the maximum integer and the current value in the VHTTIHE 
field. 

Since VHTTIHE only accounts for supervisor state overhead, 
detection of in- queue time slice end is performed by the processor 
timer when the virtual machine is dispatched in the problem state. 
The VMTHODTQ field in the VMBLOK is initiali2ed to the amount of 
problem state time that the virtual machine is allowed to 
accumulate before being dropped from a queue. This initial value 
is set by the scheduler (DHKSCH) when the virtual machine is added 
to a queue and its value depends on the queue entered (interactive 
or noninteractive) and on the processor model. For example, the 
inxtial value of VHTHOUTQ for a user entering Q1 {interactive} on a 
Hodel 145 is 300 milliseconds, while for the same user entering Q2 
(noninteractive) it is 2 seconds. Each time the user is 
dispatched, the value in VMTMOOTQ is entered into the processor 
timer; whenever the user is interrupted, the decremented processor 
timer is stored into VHTHOOTQ prior to being set from the new 
VHTTIHE. When the problem state time slice has been exhausted; a 
processor timer interrupt occurs, the VHQSEHD flag bit is set in 
the VHBLOK, and the scheduler drops the user from the queue. At 
each queue drop, the problem time used in-queue (the difference 
between VHTHOUTQ and the initial value) is added to the total 
problem time field (VMVTIME) in the VHBLOK. 

Virtual processor timer simulation is handled for EG mode virtual 
machines if the value in the virtual processor timer is less than 
that in VHTHOUTQ. In this case, the VHBLOK is flagged as "tracking 
processor timer" and a processor timer interrupt is interpreted as 
a virtual timer interrupt rather than as an in-queue time slice 
end. 



Virtua l Timing Facilities 

Virtual location X'50' timers are updated by the elapsed processor time 
each time the dispatcher has been entered after a running user has been 
interrupted. The size of the update is the difference between the value 
of the timer at dispatch (saved in QUAHTDH at location X'54') and the 
value of the timer at the time of the interruption (saved in QUAHTUHR at 
location X'tC 1 ) . 

Virtual clock comparator requests are handled by the virtual timer 
maintenance routine, DHKTHR. They are inserted into the general 
comparator request stack and the virtual machine is posted when the 
interruption occurs. 

Virtual clock comparator requests to set the virtual processor timer 
place the new value into the ECBLOK. Requests to store the new value 
update the ECBLOK field with the virtual processor time used since the 
last entry to dispatch and pass the value to the user. Requests to set 
the time-of-day clock are ignored. 

A real interval timer or processor timer is one that runs when the 
virtual machine is executing or is in a self-imposed wait state (that 
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is, the wait bit is on in the virtual PSW) « A real timer does not run 
if the virtual machine is in a CP pseudo wait state (for example, page 
wait or I/O wait) or if the virtual machine can be run but is not being 
dispatched because of other user interaction. Real timers provide 
accurate interrupts to programs that depend on measurement of elapsed 
processor and/or wait time. They do not accurately measure wall time — 
the TOD clock must be used for this function. 

An EC mode virtual machine with the real timer option has both a real 
interval timer and a real processor timer. Real timer requests for 
waiting machines are maintained in the clock comparator stack, 
processor timer requests are added to TOD clock value at the time that 
they are issued. Interval timer requests must have their units 
converted. In addition, if the virtual processor timer contains a large 
negative value, then a real timer request is scheduled to occur when the 
virtual machine becomes positive, so that the pending timer interruption 
can be unflagged. Comparator requests for real timer interruptions are 
inserted into the stack whenever a virtual machine enters a self-imposed 
wait. They are removed either when the virtual machine resumes 
execution or when it is forced (or places itself) into a pseudo wait. 



I/O Management 

I/O SUPERVISOR 

The module, DMKIOS, handles the I/O requirements of all system devices 
except the following terminals: 1052, 3210, 3215, 2150, 2741, 3270 
remote equipment, and compatible teletypewriter devices. Scheduling and 
interruption handling for these devices is essentially a synchronous 
process and does not require the queuing and restart services of DHKIOS. 
This is handled by the module DHKCHS. For handling the I/O requirements 
of 3270 remote equipment, refer to "Programming for 3270 Remote 
Terminals - an Introduction" in this section. 

REAL I/O CONTROL BLOCKS 

To schedule I/O requests and control the activity of the I/O devices of 
the system, I/O control uses several types of control blocks. These 
blocks are separated into two basic types. 

• Static blocks that describe the components of the I/O system. 

• The dynamic blocks that represent active and pending requests for I/O 
operations. 

The I/O devices of the real system are described by one control block 
for each channel, control unit, and device available to the control 
program. Units present but not represented by control blocks are not 
available for either user- initiated or CP-initiated operations. 

Because all virtual machines are run in the problem state, any 
attempt to issue a SIO instruction results in a program interruption 
that indicates a privileged operation exception. This interruption is 
handled by CP*s first level program interrupt handler, DBKPRGIH. It 
determines if the virtual machine was in virtual supervisor state 
(problem state bit in the virtual PSW is zero) . If so, the instruction 
causing the interruption is saved in the VMBLOK for the virtual machine 
and control is transferred to the privileged instruction simulator, 
DMKPRVLG, via a GOTO. 

■* 
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DHKPRVLG determines if the privileged operation affects the virtual 
I/O configuration. DMKPRVLG simulates non-I/O privileged instructions 
(such as LPSW) . If the instruction's operation code is from X*9C to 
X'9F', control is transferred to DMKVSIEX. 

After clearing the condition code in the user's VHBLOK, DMKSCHVU is 
then called to locate the virtual I/O blocks representing the I/O 
components (channel, control unit and device) addressed by the 
instruction. DMK7SIEX then branches to handle the request based on the 
operation requested. 

In attached processor systems, the I/O control blocks are protected 
by forcing all critical execution paths in CP to operate on the main 
processor. 

VIRTUAL I/O REQUESTS 

The virtual I/O interface maintained by CP provides to the software 
operating in tne user's virtual machine, the condition codes, csii status 
information, and interruptions necessary to make it appear to the user's 
virtual machine that it is in fact running on a real System/370. The 
virtual I/O interface consists of: 

• A virtual I/O configuration for each active virtual machine that 
consists of a set of I/O control blocks that are maintained in the 
Control Program's free storage. This configuration is built at logon 
time from information contained in the user's directory file, and can 
be changed by the user or the system operator. 

• A set of routines that maintain the status of the virtual I/O 
configuration. 

• Other system routines that simulate or translate the channel programs 
provided by the user to initiate I/O on units in the real system's 
configuration. 



Virtua l SIO 

With a SIO, the condition code returned from DHKSCHVU is tested to 
verify that all addressed components mere located. If they were not, 
then a condition code of 3 (unit not available) is placed in the PSW and 
control returns to the dispatcher. Otherwise, the addresses of the 
appropriate virtual I/O control blocks are saved, and DHKVSIEX tests the 
status of the addressed I/O units by scanning the VCHBLOKs, VCUBLOKS, 
and VDEVBLOKs to locate the block that contains the status of the 
addressed subchannel. The subchannel status is indicated in: 

• The VCHBLOK for a selector or block multiplexer channel. 

• The VCUBLOK for a shared selector subchannel on a byte multiplexer 
channel. 

• The VDEVBLOK for a nonshared subchannel on a byte multiplexer 
channel. 

When the block containing the status is found, the status is tested. 
If the subchannel is busy or has an interruption pending, condition code 
2 is placed in the virtual PSW. Otherwise, the subchannel is available 
and the device and the control unit are tested for interruption pending 
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or busy. If either is found, condition code 1 is placed in the virtual 
PSW and the proper CSH status is stored in the virtual Machine's page 
zero. If all components in the subchannel path are free, DHKVSIEX 
proceeds to simulate the SIO by locating and loading the contents of the 
virtual machine* s CAW from virtual location X'48' and testing the device 
type of the unit addressed. 

The device type is in the VDEVBLOK. If the device class code 
indicates a terminal or console, control is passed to the module 
DHKVCNEX with a GOTO. DHKVCNEX interprets and simulates the entire 
channel program, moving the necessary data to or from virtual storage 
and reflecting the proper interruptions and status bytes. When DHKVCNEX 
has finished, it passes control directly to the dispatcher, DHKDSPCH. 

If the referenced device is a spooled unit record device, DHKVSIEX 
passes control to DHKVSPEX for additional processing. When control 
returns to DHKVSIEX, it passes control to DHKDSPCH. 

If the device is not a terminal or a spooling device, the SIO is 
translated and executed directly on the real system's I/O device. 
DHKVSIEX calls DHKFREE to obtain free storage and then it constructs an 
IOBLOK in the storage obtained. The IOBLOK serves as an identifier of 
the I/O task to be performed, it contains a pointer to the channel 
program to be executed and the address of the routine that is to handle 
any interruptions associated with the operation. 

DHKVSIEX stores the contents of the user's CAW in IOBCAW and sets the 
interruption return address (IOBIRA) to be the same as the virtual 
interruption return address (DHKVIOIN) in DHKVIO. The CCW translation 
routine (DHKCCWTR) is then called to locate and bring into real main 
storage all user pages associated with the channel program, including 
those containing data and CCWs. The following occurs: 

• The CCWs are translated. 

• A corresponding real channel program is constructed. 

• The data pages are locked into real storage. 

• DHKCCWTR returns control to DHKVSIEX. DHKVSIEX places the user in a 
pseudo wait state, IOWAIT, and calls the real I/O scheduler DHKIOSQV 
to schedule the I/O on the real configuration. 

DHKIOSQV gueues the request for operation on the real channel, 

control unit, and device corresponding to the address used by the 

virtual machine. When the real SIO is issued, DHKIOS takes the user out 

of IOWAIT and reflects the condition code for the SIO if it is zero. If 

it is not zero, the operation is further analyzed by DHKVIOIN. In any 

case, DHKIOSQV returns control to DHKVSIEX, which passes control to 
DHKDSPCH. 



O ther Privileged I/O Instructions 

Other privileged I/O instructions are handled directly by DHKVSIEX. 
DHKVSIEX scans the virtual channel, control unit, and device blocks in 
the same manner as for a SIO and reflects the proper status and 
condition to the virtual machine. In some cases (TIO) , the status of 
the addressed devices is altered after the status is presented. 
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If the operation active on the virtual device is actually in progress 
in the real equipment, the simulation of a HIO or HDV is somewhat more 
involved, since it requires the actual execution of the instruction. In 
this case, the active operation is halted and the resultant condition 
code/status is returned to the user. 



Virtual Channel-to-Channel Adapter 

The virtual channel-to-channel adapter (CTCA) simulates data transfer 
and control communication between two selector channels, either on two 
distinct processors or two channels on a single processor. Data 
transfer is accomplished via synchronized complementary I/O commands 
(for example, read/write, write/read) issued to both parts of the CTCA. 
Each part of the CTCA is identical and the operation of the unit is 
completely symmetrical. The CTCA occupies an entire control unit slot 
on each of the two channels attached. The rightmost four bits of the 
unit address (device address) are ignored completely and are not 
available tor use. 

The VM/370 control program support for virtual CTCA includes all 
status, sense data, and interruption logic necessary to simulate the 
operation of the real CTCA. Data transfer, command byte exchange, sense 
data, and status data presentation for the virtual CTCA is accomplished 
via storage-to-storage operations (MVCL, etc.). Ho real I/O operations 
(excluding paging I/O) nor I/O interruptions are involved. Unit errors 
or control errors cannot occur. 



Virtua l Selector Channel I/O Requests 

The CCW translator, DMKCCWTR, is called by the virtual machine I/O 

executive program (DMKVSIEX) when an I/O task block has been created and 

a list of virtual CCWs associated with a user's SIO request must be 
translated into real CCWs. 

When the I/O operation from a self-modifying channel program is 
completed, DMKUNTIS is called by DMKIOS. When retranslation of OS ISAM 
CCWs is required, the self-modifying channel program checking portion of 
DHKCCWTR calls DMKISMTR. 

DMKCCWTR operates in two phases: 

• A scan and a translate phase. 

• A TIC-scan phase. 

A self-modifying channel program checking function is also included. 

The scan and translate phase analyzes the virtual CCW list. Some 
channel commands require additional doublewords for control information 
(for example, seek addresses) . Additional control words are also 
allocated (in pairs) if the data area specified by a virtual CCW crosses 
4 096-byte page boundaries, or if the virtual CCW includes an IDA 
(indirect data address) flag. 

Space is obtained from DMKFREE for the real CCW list, and the 
translation phase then translates the virtual CCW list into a real CCW 
list. TIC commands that cannot be immediately translated are flagged for 
later processing by the TIC-scan phase. A READ or WRITE command that 
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specifies that data cross 4096-byte boundaries is revised to include an 
IDA flag that points to an indirect data address list (I DAL) and a pair 
of words for each 4096-byte page, in which each word handles a data 
transfer of 2048 bytes (or less) . The real CCW is flagged as having a 
CP-generated IDA. DMKPTRAN is called (via the TRANS macro) to lock each 
4096-byte page. 

If the real CCW string does not fit in the allocated free storage 
block, a new block is obtained. The old block is transferred and 
adjusted before being released. The translation continues with the new 
block. The process is repeated, as needed, to contain the real CCW 
string. 

Virtual CCWs having an IDA flag set are converted to user translated 

addresses for each IDAW (indirect data address word) in the virtual 

IDAL. DMKPTRAN is called for each IDAW is. The CCW is flagged as 
having a user (but not CP) generated IDA. 

The TIC-scan phase scans the real CCW list for flagged (untranslated) 
TIC commands and creates a new virtual CCW list for the untranslated 
commands. Scan-translate phase processing is then repeated. When all 
virtual CCWs are translated, the virtual CAW in the IOBLOK task block is 
replaced by the real CAW (that is, a pointer to the real CCW list 
created by DHKCCWTR) , and DHKCCWTR returns control to DMKVIOEX. The 
user protection key is saved. 



OS ISAM Handling by. DMKISMTR 



Because many of the OS PCP, MFT, and MVT ISAM channel programs are 
self-modifying, special handling is required by the VM/370 control 
program to allow virtual machines to use this access method. The 
particular CCWs that require special handling have the following general 
format: 



RSADDATA C*7 10 b v tes 
1 1| Z1\JL 



TIC to E 



I- 



I 



SEEK: SEEK head on D 
I 1 1 



SEARCH on D+2 



The CCW at A reads 10 bytes of data. The tenth byte forms the 
command code of the CCW at E. In addition, the data read in makes up 
the seek and search arguments for the CCWs at E and F. After the CCW 
string is translated by the VM/370 control program, it usually is in the 
following format: 
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READDATA C + 7 10 bytes 
1 1 1 



TIC to 3 



SEEK: SEEK head on 6 
-I , ,. 



SEARCH on D+2 
| 1 



etc. 
— 1_ 

I 



ISAM word 



To accomplish an efficient and non-timing-dependent translated 
operation for OS ISAM, the virtual CCW string is modified in the 
following manner. 

DMKISMTR is called by DHKCCWTR if, during normal translation, a CCW 
of the type at 1 is encountered. The scan program locates the TIC at 2 
by searching the translated CCW strings. The TIC at 2 locates the SEEK 
at 3. 

The virtual address of the virtual SEEK CCW at E is located from the 
RCWTASK header. Seven doublewords of free storage are obtained and the 
address of the block is saved in the ISAH control word at 5. The seven 
doublewords are used to save the following information from the 
translated CCW strings: 



8 
9 
10 
11 
12 
13 



r - 

I Address of Read 
I at 1 


31 . 


Address of 
at 2 


i 

TIC | 


I Unused 




Onused 




I Data area 


for READ at 1 




I SEEK HEAD 


on 9 




I TIC 


to 


4 




I Image of 


READ CCW at 1 




I Image of 


TIC 


CCW at 2 





The translated read CCW (at 1) is moved to the save block at 12. The 
TIC CCW (at 2) is moved to the save block at 13, 'and the addresses of 1 
and 2 are saved at 7. The read CCW at 1 is modified to point to a 
10-byte data area at 8+7 in the save block. The seek head CCW at 3 is 
copied into the save block at 10, and the seek address is modified to 
point to the data area at 9. At 11, a TIC CCW is built to rejoin the 
translated CCW string at 4. The search at 1 (or any subsequent search 
referencing D+2) is modified to point to 9+2. The completed CCW string 
has the following format: 
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7 

8 

9 

10 

11 



1 


Readdata 8*7 


10 Bytes 


i 


I TIC to 10 | 


I Unused | 




Search on 9 + 


2 




I Etc. | 


I | ISAH word | 




i I 


i ... 




I | Unused | j 
i f i i i 


i II i i 

( Data Area for Readdata | 


1 | Seek Head on 9 | 




TIC to 4 







The interruption return address in the IOBLOK is set to DMKUNTIS. 
DMKUNTIS restores the CCWs to their original format froi the seven 
doubleword extensions, moves the 10 bytes of data from 8+7 into virtual 
storage (at C+7) , and releases the block- Normal I/O handling is 
resumed by DMKVIO and DMKUNT. 



I/O COMPONENT STATES 



The I/O components represented by the control blocks described in "Real 
I/O Control Blocks" are in one of four states and the state is indicated 
by the flag bits in the block status byte. If the component is not 
disabled, it is either busy, scheduled, or available. 

If the disabled bit is on, the component has been taken offline by 
the operator or the system and is at least temporarily unavailable. A 
request to use a disabled component causes the IOBLOK to be stacked with 
an indication of condition code 3 on the SIO and the real SIO is not 
performed. 

An I/O unit is busy if it is transferring data (in the case of a 
channel or control unit), or if it is in physical motion (in the case of 
a device) . If an I/O unit is busy, the IOBLOK for the request is queued 
from the control block representing that I/O unit. 

An I/O unit is scheduled if it is not busy but will become busy after 
a higher-level component in the subchannel path becomes available and an 
operation is started. For example, if a request is made to read from a 
tape drive and the drive and control unit are available, but the channel 
is busy, the IOBLOK for that request is queued from the RCHBLOK for the 
busy channel and the RCUBLOK and RDEVBLOK of the drive and control unit 
are marked as scheduled. Future requests to that drive are queued from 
the RDEVBLOK for the scheduled device. When the channel completes the 
operation, the next pending operation is dequeued and started; the 
scheduled control unit and device are then marked as busy. 

The IOBLOK s for various I/O requests indicate the status of that 
request by a combination of the status bits in the IOBLOK and the queue 



CP Introduction 



1-89 



in which the block resides. In general, an IOBLOK is queued from the 
control block of the highest level I/O unit (taken from device up to 
channel) in the subchannel path that is not available. Once the I/O 
operation is started, the IOBLOK is chained from the active IOBLOK 
pointer (RDEVAIOB) in the real device control block. Flags in the 
IOBLOK status fields may also indicate that a unit check has occurred, 
that a sense is in progress, or that a fatal I/O error (unrecoverable) 
has been recognized by error recovery procedures. After I/O control 
releases control of the IOBLOK, it is stacked on the queue of IOBLOKS 
and CPEXBLOKs anchored at DMKDSPRQ in the dispatcher and control is 
passed to the second- level interruption handler whose address is stored 
in IOBIRA, 



I/O INTERRUPTIONS 

I/O interruptions are either synchronous or asynchronous. Asynchronous 
interruptions indicate the change in status of an I/O unit from the 
not-ready to ready state or busy to not-busy state. In either case, if 
the affected component has any pending requests queued from its control 
block, they are restarted, and whether or not the given interrupt is 
processed any further depends upon the status of the interrupting 
component. Channel-available and control- unit-end interruptions restart 
the interrupting component. An asynchronous device end is passed to the 
user if the device is dedicated; otherwise, the device is restarted. 

An interruption is considered to be synchronous if the interrupting 
device has a nonzero pointer to an active IOBLOK. In this case, the 
following processing occurs: 

• If a unit check has occurred, a sense is scheduled, and when the 
sense is completed, the appropriate ERP is called. 

• If an ERP is currently in control of the task (indicated by a flag in 
the IOBLOK), return the IOBLOK to the appropriate ERP. 

• If the operation is incomplete (for example, channel end is received 
without device end) , the IOBLOK is copied and the copy is stacked but 
the original IOBLOK remains attached to RDEVAIOB to receive the final 
interrupt; then, the control unit and the channel is restarted. 

• If the operation is complete (that is, the device is available) , the 
IOBLOK is detached from the device and stacked, and the device, 
control unit and channel are restarted. 

The restart operation usually dequeues the next IOBLOK that is queued 
to the restarted component and queues it to the next higher component in 
the subchannel path. When the channel level is reached, a SIO is issued 
and exit is taken to the dispatcher after handling any nonzero condition 
codes as previously described. 



VIRTUAL I/O INTERRUPTIONS 

When an I/O interruption is received, the IOBLOK is stacked for 
dispatching and control is passed to the address specified in the IOBIRA 
(interrupt return address) field. For operations requested by DHKVIOEX, 
the return address is DMKVIOIN (virtual interrupt return address) . When 
DMKVIOIN receives control from the dispatcher, it loads the virtual 
address of the unit with which the interruption is associated from the 
IOBLOK and calls DMKSCNVU to locate the virtual device control blocks. 
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DHK7I0IN then tests the IOBLOK status field to determine the cause for 
the interruption- If the block has been unstacked because of an 
interruption, the field is zero. If the operation was not started, it 
contains the condition code from the real SIO. 

Note: The VIRA should not see a real condition code 2 as the result of a 
SIO, since channel- busy conditions are detected and reflected before any 
real I/O operation is attempted. 

A condition code of 3 is reflected virtual machine and exit is taken 
to the to the dispatcher. For a condition code of 1, the CSW status 
field in the IOBLOK is examined to determine the cause for the CSV 
stored condition. The status is reflected to the virtual machine and 
various components of the virtual configuration may be freed, if the 
status so indicates. For example, if the CSW status indicated both 
channel end and device end, the operation was immediate and has 
completed. Thus, the CCW string (real) may be released and all virtual 
components marked available. 

The CSW status returned for a virtual interruption must be tested in 
the same manner, with the additional requirement that the status be 
saved in the affected virtual I/O control blocks and that the CSW be 
saved in the VDE7CSW field for the device causing the interruption. If 
the unit check bit is on in the status field, the sense information 
saved in the associated IOERBLOK (pointed to by the IOBLOK) must be 
retained so that a sense initiated by the virtual machine receives the 
proper information. 

In any case, when an interruption is received for a virtual device, a 
bit in the interruption mask, VCUDVINT, for the device's control unit is 
set to 1. The bit that is set is the one corresponding to the relative 
address of the interrupting device on the control unit. For example, if 
device 235 interrupts, the fifth bit in the VCUDVINT mask in the 7C0BLCK 
for control unit 30 on channel 2 is flagged. Similarly, the bit in the 
YCHCUINT in the affected VCHBLOK is also set; in this case, bit 3 in 
VCHBLOK for channel 2. If the interruption is a channel class interrupt 
(PCI or CE) , the address of the interrupting unit (235) is stored in the 
VCHCEDEV field in the VCHBLOK. The final interruption flag is set in 
the VMPEND field in the VMBLOK for the interrupted virtual machine; the 
bit set corresponds to the address of the interrupting channel. The 
next time, the virtual machine is dispatched and becomes enabled for 
I/O. 



SCHEDULING I/O REQUESTS 

A task that requests an I/O operation must specify the device on which 
the operation is to take place and must provide an IOBLOK that describes 
the operation. Upon entry to DMKIOS, register 10 must point to the 
IOBLOK. The IOBLOK must contain at least a pointer to the channel 
program to be started in IOBCAW and the address to which the dispatcher 
is to pass control in IOBIRA. In addition, the flags and status fields 
should be set to zero. If the operation is a VH/370 control program 
function such as for spooling or paging, the entry point DHKIOSQR is 
called. If the requester is the virtual I/O executive (DHKVIOEX) 
attempting to start a virtual machine operation, the entry point 
DMKIOS QV is called and some additional housekeeping is done. In either 
case, an attempt is made to find an available subchannel path from the 
device to its control unit and channel. If an I/O unit in the path is 
busy or scheduled, the IOBLOK for the request is queued to the control 
block of the I/O unit. 
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Requests are usually queued first-in-first-out (FIFO) , except those 
requests: 

• To aovable-head DASDs that are queued in order of seek address 

• That release the affected coaponent after initiation (SEEKS and other 
control coaaands) which are queued last-in-first-out (LIFO) froa the 
control block 

Whether or not the operation has been successfully started, the 
caller requesting the I/O operation receives control froa DMKIOS. If a 
free path to the device is found, the unit address is constructed and an 
SIO is issued. If the resulting condition code is zero, control is 
returned to the caller; otherwise, the code is stored in the 
requester's IOBLOK along with any pertinent CSU status, the IOBLOK is 
stacked, any coaponents that becoae available are restarted, and control 
is returned to the caller. 



Alternate Path Scheduling 

Alternate path I/O scheduling is perf oraed according to the following 
scheae: 

DMKIOS searches for an available path beginning with the priaary path 
to the device. If an available path to the device exists, the I/O 
request is started iaaediately on the first available path to the 
device. 

If the device is busy or scheduled, the IOBLOK is queued off the 
RDEVBLOK. Ho alternate path processing is perf oraed at the device level. 

If the device is not busy, not scheduled, nor offline, an IOBLOK for 
this I/O request is proaoted upward to the RCDBLOK or RCHBLOK level in 
search of an available path. If a busy or scheduled path is 
encountered, an IOBLOK is queued to the real block and the search 
continues for an available path. If aore than one busy path is 
encountered, multiple IOBLOK s are queued for the saae I/O request. This 
is accomplished by creating aini IOBLOKs for each busy/scheduled path 
after the first. The priaary IOBLOK is queued off the first busy path 
encountered. The aini IOBLOK is 16 bytes in length and consists of the 
first two doublewords of the IOBLOK, which is the saae as the current 
IOBLOK structure. The IOBLOK and associated mini IOBLOKs are chained in 
a single-threaded queue by Beans of the IOBLIHK field. The active 
IOBLOK pointer is not stored in the IOBLINK field until just prior to 
the SIO. Zeros are stored in IOBLINK at entry to DHKIOSQR to indicate 
no mini IOBLOKs have been queued as yet. See Figure 17 for an exaaple 
of aini IOBLOK queuing. 

The last two words of the aini IOBLOK (IOBFPHT and IOBBPNT) are used 

as the double-threaded queue pointers for the RCOBLOK/RCHBLOK froa which 

it is queued. A flag is set in the aini IOBLOK to identify it as a aini 
IOBLOK. 

Figure 18 shows a saaple control block structure when aini IOBLOKs 
are queued. 
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Prior to starting an I/O operation associated with the request, a 
check is made to see if the IOBLOK is a nini IOBLOK and whether lini 
IOBLOKs are queued off this IOBLOK. All mini IOBLOKs associated with 
this request are dequeued froi their respective queues by running the 
IOBLINK chain. The storage for the blocks is released. If the active 
IOBLOK is a mini IOBLOK, the IOBRADD from the mini IOBLOK is moved to 
the primary IOBLOK and the I/O started using the primary IOBLOK. Once 
the storage for the mini IOBLOKs has been released and the SIO 
initiated, any busy condition encountered causes the IOBLOK to be queued 
on this same path. That is, there will be no alternate path scheduling 
after the SIO if a busy condition is encountered. The I/O request will 
be restarted on the same path as the original request. 



Reserve/Release 



Reserve/release is supported for shared DASD as though each virtual 
machine has a separate channel path to a shared device. Reserve /release 
support prevents the occurrence of a channel lockout situation. This is 
accomplished by changing reserve CCfls to sense CCWs when a reserve is 
issued to a device that has alternate paths defined to it. This means 
that whenever alternate paths are defined to a device, the real reserve 
does not execute on the hardware. Reserve /release support is 
implemented in 7M/370 on a virtual basis allowing the reserve /release 
operation codes to be simulated on a virtual basis for minidisks, 
including full-extent minidisks. When a reserve is issued against a 
minidisk, the reserve is accomplished by a locking mechanism. The status 
of the minidisk is maintained in the VRRBLOK that is chained from the 
VDEVBLOK. 



The following matrix identifies 
handled in the various situations. 
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DMKVIO 

DMKVIO performs the following steps when virtual reserve /release 
processing is requested: 

1. DMKVSI calls DMKCCW to perform CCW translation. For DASD devices, 
DMKCCW checks if the virtual reserve/release feature bit is on in 
the VDEVBLOK. If virtual reserve/release processing has been 
requested and if the device is not reserved by anyone or it is 
reserved by this user, processing continues normally- If the device 
is reserved by another user, DMKCCW calls DMKUNTFR to restore the 
CCWs to their original state and returns to the caller, unless sense 
bytes have been transferred to the user*s storage in which case CP 
enqueues on the minidisk and waits until it is no longer reserved at 
which time the I/O can proceed. If the I/O request can continue and 
the CCW chain contains a reserve command, the VDEVBLOK and the 
VHRBLOK are flagged as reserved. If the CCW chain also contains a 
release, the IOBLOK is flagged to indicate to DMKUNTFR to release 
the virtual disk. Control returns to DMKVSI. 

2. DMKVSI reflects a device-busy condition to the virtual machine if 
the minidisk is currently reserved by another user. 

3. DMKUNT reflects a device end interrupt to all virtual machine users 
who previously received a busy condition, when the device is 
released. 

O rdere d Seek Queuing: Requests to start I/O on system devices are 
normally handled first in first out. However, requests to movable-head 
DASD devices are queued on the device in ascending order by seek 
address. This ordered seek queuing is performed to minimize 
intercylinder seek times and to improve the overall throughput of the 
I/O system. 

CP assumes that very few virtual machines perform chained SEEKs. 
Therefore, the first logical address represents the position of the arm 
upon completion of the I/O operation. Ordered SEEK queuing is based on 
the relocated real cylinder. DMKIOS uses the cylinder location supplied 
in IOBCYL for ordered SEEK queuing. This field is initialized by the 
calling CP routine for paging and spooling or by the CCW translator for 
virtual I/O. The CCW translator, DMKCCW^ supplies the IOBCYL value in 
the following manner: 

• Reads the IPL record, relocates to virtual cylinder 

• Recalibrates, issues a real calibrate, and then a SEEK to virtual 
cylinder 

• Issues a channel SEEK, relocates to the virtual cylinder 

The IOBLOK queuing subroutine of DMKIOS recognizes that a request is 
being queued on a movable-head DASD by means of the device class and 
type fields of RDEVBLOK. Instead of adding the IOBLOK to the end of the 
queue on the RDEVBLOK, the queuing routine sorts the block into the 
queue based on the cylinder number for the request. The cylinder number 
for any request to DASD is recorded in the IOBCYL field. The queue of 
IOBLOKs on a real device block is sorted in ascending order by SEEK 
address, unless the entire device is dedicated to a given user. In this 
case, DMKIOS does not automatically schedule the device, and no more 
than one request can be outstanding at any one time. 
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When an outstanding I/O request for a device has completed, DMKIOS 
attempts to restart the device by dequeuing and starting the next IOBLOK 
queued on the device. For non-DASD, this is the first IOBLOK queued. 
However, for movable-head DASD, the queued requests are dequeued in 
either ascending or descending order, depending upon the current 
position (recorded in RDEVCYL) and the direction of motion of the arm. 
If the arm is seeking up (that is, toward the higher cylinder numbers) , 
the queue of IOBLOKs is scanned from the first block toward the last 
until an IOBLOK is found with an IOBCYL value equal to or greater than 
the value in RDEVCYL, or until the end of the queue is reached. At this 
point, the device is flagged as seeking down and the queue is scanned 
from last to first until an IOBLOK with an IOBCYL value equal to or less 
than RDEVCYL is found. When the IOBLOK is found, it is dequeued and 
started. The direction of motion is indicated by an RDEVFLAG bit and 
the next request is dequeued downward until the head of the queue is 
reached. 

Because the queue itself is a two-way chained list, no special 
handling for null or unity set lists is required, and the ordered seek 
algorithm returns to first-in-first-out queuing. 

Dedicated Channel Support; One of the facilities of the VM/370 control 
program allows a virtual machine to control one or more channels on a 
dedicated basis. The channels are attached to the virtual machine by 
using the privileged ATTACH CHANNEL command. A virtual machine can have 
one or more dedicated channels. In addition, channels can be split 
between virtual machines but a dedicated channel cannot be shared 
between two virtual machines. For instance, channel 1 could be 
dedicated to virtual machine A, and channel 2 could be dedicated to 
virtual machine B, or both could be dedicated to virtual machine A or B. 

With a dedicated channel, all virtual machine device addresses must 
be identical to the real machine device addresses. For instance, 
virtual device 130 must be real device 130, and virtual device 132 must 
be real device 132. With dedicated channels, CP does not perform any 
virtual device address mapping. 

CP error recording and channel recovery procedures are still in 
effect for dedicated channels. The dedicated channel support can be 
used in conjunction with the virtual=real feature for any virtual 
machine that is occupying the virtual=real storage space. 



VIRTUAL CONSOLE SIMULATION 

DMKVCN receives control from the virtual machine I/O executive, DHKVIO. 
When control is received, the device is available with no interruptions 
pending. A console control block, VCONCTL, that is obtained from storage 
and chained from the virtual device control block, VDEVBLOCK, by DMKLOG 
is accessed for use during the interpretation of the virtual console I/O 
sequence. The user's CAW is examined for validity. If it is valid, the 
TRANS macro is issued to fetch the first user CCW. This CCW is moved to 
the VCONCTL block for analysis. 

The CCW is analyzed to determine if it is a read, a write, a control, 
a sense, a TIC, or an invalid operation. Based upon the analysis, the 
appropriate processing routine in DMKVCN is invoked. 

l^e Read Simulation Routine: Obtains a buffer for input data from free 
storage. The~location~of the buffer is set in the VCONCTL block. The 
DMKQCNRD routine is called to schedule and perform an actual read to the 
corresponding real device representing the user's virtual console. If 
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SET LINEDIT ON is specified, the buffer data is edited and translated to 
EBCDIC. When the read is completed, the data is moved to the specified 
user address obtained from the address portion of the virtual CCW. If 
command chaining is specified, processing returns to fetch and analyze 
the next CCW. If command chaining is not specified, the virtual CSW is 
constructed in the VDEVBLOK and an interrupt is flagged as pending in 
the VMBLOK. 

The Write S imulation Routine: Obtains a buffer for the construction of 
the output message from free storage. The virtual machine data is 
located from the virtual CCW address in the VCOHCTL block and moved to 
the data buffer. The DMKQCHWT routine is called to write the data in 
the buffer and provide the necessary length, translation, and format 
functions. Control is received at the DHKVCN module upon completion of 
the writing. At this point, the virtual CCW is re-examined. If command 
chaining is specified, processing continues to fetch and analyze the 
next CCW. If command chaining is not specified, the virtual CSW is 
constructed in the VDEVBLOK and an interruption is flagged as pending in 
the VMBLOK. 

The Control Simulatio n Routine; Is used for the SOP and ALABM 
operations. A HOP operation reguires no data transfer or I/O operation. 
An ALARM operation has no eguivaient on low-speed teleprocessing 
eguipment; thus, a message indicating the ALARM operation is 
constructed. DMKQCNWT is called to output the constructed message. If 
the command is chained, processing continues (for NOP or ALARM) to fetch 
the next CCW and analyze it. If command chaining is not specified and 
this is not the first CCW, a virtual CSW is constructed in the VDEVBLOK 
and an interruption is flagged as pending in the VMBLOK. If this is the 
first (and only) CCW, then a condition code of 1 is presented with 
channel end and device end in the virtual CSW. 

k Virtual Sense O peration : Is similar to a control operation, because no 
actual I/O operation is performed. However, there is data transfer. 
The sense data from the VDEVBLOK is moved to the virtual storage 
location specified in the virtual CCW address. If the command is 
chained, processing continues to fetch the next CCW and analyze it. 
Otherwise, an interruption is flagged as pending in the VMBLOK. 

k Virtual TIC Operatio n: Fetches the virtual CCW addressed by the TIC 
address and analyzes the fetched CCW. If the fetched CCW is itself a 
TIC, or if the TIC is the first CCW, a channel program check condition 
is reflected to the virtual machine as an interruption or as a 
CSW-stored condition, respectively. 

Invali d Operation : Any other operation is considered invalid. Command 
reject status is posted in the virtual sense byte and the operation is 
terminated with unit check status presented in the virtual CSW. 



REMOTE 3270 PROGRAMMING 

For a basic understanding of CP processing of data relating to 3270 
devices on binary synchronous lines, the information and terminology 
contained in IBM 327 I nform ation Display System Component Description « 
and General Information - Binary Synchrono us Communications is required. 

A digest of some of this essential information as it applies to 
VM/370 follows: 
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Text messages to and from remote terminals and printers can only be 
achieved when the bisync line is in text mode. 



Text messages fro 
poll or specific 
the bisync line 
accomplished by 
specific poll and 
terminal list of 
addresses. This 
system generation 
For more details 
Planning and Syste 



m a remote device can be the result of a general 

poll operation to the related device or devices on 

This polling communication interface is 

each line-connected control unit having unique 

general poll recognition circuitry and by the CP 
valid bisync lines and 3270 remote control unit 
list, the terminal list, is generated by VM/370 

procedures employing TERMINAL and CLUSTER macros. 

about terminal list generation, see the VM/3 70 
m Generation Guide. 



Reliability and dependability of line operation is achieved by the 
use of: a double addressing scheme, control characters with a rigid 
message protocol, and complex redundancy-check characters appended to 
transmission messages. Examples of these techniques are shown in the 
formats that follow. 

Every message (text or control) that is issued by CP may or say not 
be responded to by the remote station or control unit. The type of 
response (or absence of response) that CP receives depends on the 
receptiveness of that device or control unit to the previously sent 
message (is the device ready and enabled and accurately addressed) 
and the content and correctness of the message (no line errors) . 

To establish the relationship of the line of terminal response to a 
particular line or device write or read operation, CP employs an 
operation "tracking" facility (TP op code) imbedded in the issued 
CCWs. The function performed by the CP op code is described in the 
following CCW formats. 



Format of the 3270 Remote CCW 



(Operation! Address IFlags |TP Op | Count | 

| Code | Field | | Code | | 

I 1 byte | 3 bytes |1 byte|1 byte | 2 bytes | 

i i 



7 8 



31 32 39 40 47 48 



63 



where: 

Operation Code 

contains the hexadecimal value of the type of operation 
performed by the command. 

Valid operation codes are: 



X»01« 


WRITE 


X'02» 


READ 


X»03« 


NO-OP 


X»09» 


POLL 


X«23« 


SET MODE 


X«27« 


ENABLE 


X«2F« 


DISABLE 



Address Field 

Depending on CCW usage, this field may address an: 
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Area 

The address of the data area (read buffer) located in the 
BSCBLOK at BSCREAD. 

Table 

The appropriate location in the table of data-link control 
characters provided in the module DHKGRF (Example: RVI, EOT, 
ENQ). 

Response 

(BSCRESP) . The address location of the response message in 
the BSCBLOK. 

The appropriate entry in terminal list (NICBLOKS) associated 
with the READ or WRITE operation- The entry for WRITE 
operation is at location BSCSEL- The entry for the READ 
operation is at location BSCPOLL. 

Note: To see how the key words AREA, TABLE, RESPONSE, and LIST are used, 
refer to the CCW sequences described in "I/O Program Routines for Bisync 
Lines and 3270 Remote Devices" in this section. 



List 



Flags 



The flag bits turned on in the CCW: CC (channel commands) , CD 
(chained data), SILI (suppress incorrect length indication), 

skip (suppress data transfer to main storage) and PCI 
(program-controlled interrupt) . 



>p Code 



Count 



An imbedded teleprocessing operation code in the CCWs used in 
bisync line communications. This code is inspected by the 
secondary interruption handler, DMKRGAIN, when channel end and 
device end are received. The code is also used by the error 
processing module, DMKBSC. The code indicates the function 
being performed by the associated command. For use of the TP 
op codes, refer to the formatted CCWs that follow. 

Refers to the byte length of the CCW READ or WRITE operation. 



I/O PROGRAMS FOR BISYNCHRONOUS LINES AND REHOTE 3270S 

Before data communication to remote 3270 equipment can take place, the 
remote teleprocessing line, the control unit and the device (s) must be 
enabled for communication. This occurs when control unit hardware 
recognizes a unique string of characters transmitted on the line from 
CP. Disabling a line occurs in a similar manner. The following is the 
format of the CCWs used in the enabling/disabling operation: 
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Enable a Line 



I Opera- I Command 
jtion j Code 
I 



I |TP Op 
Address (Flags ICode 



Count 



|Dis- | X»2F» 
I able | 
I Line | 



I CC, | 01 
I SILII 



|Set | X«23« 
I Mode ! 



X'UO' | CC, | 01 



I Enable | X«27* 
I Line j 

i 



| SILII 01 



Disable a Line 



| Opera- I Command | | |TP Op | 
jtion j Code lAddress IFlags ICode |Count 



|Dis- | X'2F« | 
(able | | 
I Line | | 

i 



| SILII 01 | 1 
i I I 
I I I 



After a line is enabled, communication can then be directed to a 
particular resource. The sequence of events (for a write disable and 
write continue) is as follows: 

Send a data link control character on the line that places the 
control unit in control mode. This mode makes the control unit 
receptive to the specific address indicated by the second CCW. The 
third CCW is a read CCW that is needed for the acknowledgement response 
from the addressed control unit. Normally, in response, CP transmits a 
block of data to that device with a write text CCW. Acknowledgement of 
receipt of this data is contained by the read response (write continue) 
CCW. The format of the CCW write initial and write continue operation 
follows. 



Write Initial 



lOpera- 
j tion 



Command 
Code 



Address 



|TP Op 
Flags ICode 



Count 



I Write 
j an EOT 
I 



01 



Table 



CC, | 02 
SILII 



I Write 
|ad- 
| dress- 
ling 
I char. 
I 



01 



List 



CC, | 03 
SILII 

I 

I 

I 



LIST 



(Read 
|Re- 
j sponse 

i 



02 



Response 



SILII 05 
I 
I 
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Write Continue 



| Opera- I Command | | |TP Op | 

jtion I Code j Address |Flags|Code jcount 
I 



| Write | 01 
I text I 



I Area I CC, | 10 |vari- 
i | SILII (able 



I Read | 
I Re- | 
|sponse| 

i 



02 |Response| SILII 11 | 2 
I III 

I III 



In situations vhere the line is found to be in text mode, CP can 
issue a write reset sequence to put the binary synchronous line in 
control mode. The following format illustrates the write reset CCW. 



Write Reset 



j Opera- I Command | | |TP Op | 

jtion j Code j Address JFlagslCode jcount 
I 



I Write | 01 

I EOT | 

i 



I Table | SILII 09 | 1 
I III 



In situations where the expected response from a remote station was 
not received or was invalid, the channel program may request the remote 
station to retransmit the response. The following write ENQ format 
shows this sequence. The remote station, upon receipt of the EHQ 
message, responds by transmitting the expected or valid response to the 
response area indicated by the second CCW. 

Write ENO. 



i ' — ~— — ■ 1 

(Opera- I Command | | |TP 0p| 

jtion j Code j Address JFlagsjCode jcount 



IWrite | 01 
I ENQ | 
| 



I Table | CC, | 03 | 1 
I I SILII | 



IRead | 02 IResponse | SILII 11 I 2 
IRe- | | III 

Isponsel | III 



Read operations occur following a general poll or a specific poll for 
text messages. In a general poll sequence, CP transmits the general 
poll characters to the attached control unit on the bisync line. The 
control unit recognizes the polling request, then the list (referred to 
in the poll CCW) of enabled devices is scanned for any messages that are 
queued and ready for transmission. A positive acknowledgement (yes, I 
have a message to transmit) from any of the attached devices causes the 
next CCW to be skipped. The last CCW provides the read buffer and the 
count necessary for the incoming data block from the first remote 
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station on the list that had a message queued for transmission. If, 
however, all remote stations respond with negative acknowledgement (no 
messages queued) or any station queried for a response fails to respond, 
then the channel program ends with the third CCW. The following read 
initial format shows the initial read CCW sequence. 



Read Initial 



| Opera- | Command | | |TP 0p| 
jtion | Code {Address jFlagsJCode ICount 
i 


1 — - 

| Write | 01 | Table | CC, | 02 | 1 

| EOT | | | SILII | 
I 


IPoll | 09 | List I CC, | 03 |LIST 

III I SILII | 
i 


1 

IT/n I 3 1 1 STT.T j 07 1 1 

i no- i i i i i 

I opera- 1 | III 

Ition | | III 
i 


i 

IRead | 02 | Area | SILII 10 | 162 

I Text | | III 



After CP receives a message from a remote station, it may reissue the 
initial read sequence to poll the remaining stations on the list 
(assuming the list of enabled devices was not exhausted on the first 
pass of the initial read sequence) . In the event that the list was 
exhausted on either the first or a subsequent initial read sequence, CP 
starts the poll delay, then allows the poll delay interval to expire 
before starting another read scan to the line (assuming CP has no higher 
line priority tasks to process) . If, in the process of receiving 
messages from remote stations, CP receives a message block that is 
invalid or its beginning or ending bisync control characters are not 
recognized, CP can elect to send a negative response back to the remote 
station. This negative response, the NAK control character, causes the 
remote station to retransmit the previous message to CP; this incoming 
message is processed by the second CCW of the read repeat sequence as 
shown in the format below. 



Read Repeat 



j Opera- | Command | | |TP Op | 

jtion j Code JAddress (Flags (Code ICount 



I 

| Write | 01 
I NAK | 



I Table | CC, | 06 | 
I I SILII | 



1 



(Read | 02 
I Text | 



I Area | SILI| 10 | 162 
I III 



Once CP message processing receives an error— free message from a 
remote station, CP sends an RVI control character to the remote station 
before processing the message. The remote station, upon recognition of 
the RVI character, halts the sending of additional queued data and 
responds with EOT (instead of the normal ACK0/ACK1 response) . The 
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second CCW of the read interruption sequence processes the EOT response 
from the remote station as shown in the format below. 



Read interruption 



lOpera- (Command | | |TP Op | 
jtion j Code j Address |Flags|Code ICount 



I 

IWrite | X»01« | Table | CC, | 06 | 2 
I BTI I I I SILII | 



(Read | X*02' |Response| SILII 11 | 2 
I Re- | I | | | 
|sponse| | 111 

i 



DATA FORMATS - BISYNCHRONODS LINES AND REMOTE 3270S 



CP, in conjunction with remote 3270 support, uses the following formats 
for its text messages. For a detailed explanation of the abbreviations 
used, see the I BM 32 7 Informa tion Display Syst em Component Description . 



Write Text Data Message Format 



Display commands use this message format for the placement or erasure of 
data anywhere on the display screen. The display commands that 
implement this function are: WRITE (X , F1 , )# ERASE/WRITE (X«F7M and COPY 
(X»F7«) . 

Write Data Stream 



|STX|ESC|CMD|WCC|BSA| Buffer | Orders | SBA | Buffer | 
I I I I I | Address | & Text | | Address | 

i , 



-//- 



1 



1 



1 



variable 1 



//- 



I ETX I 
I I 



Write Text Messages for the Copy Command 



The COPY command is limited to compatible printers located on the same 
control unit. Action starts by pressing a PF Xey designated for the 
COPY function. CP responds by sending a message to the control unit 
that contains both the designated printer and the display station that 
requested the action and directs the control unit to print the 
designated display buffer to the printer specified. 

The format of the COPY messages follows: 
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3271. Copy Data Stream 



i 1 

|STX|ESC| CMD |CCC| From |ETX| 
I | | X , F7» | |Address| I 

i 1 



3275 Copy Data Stream 



|STX|ESC| CMD |WCC|SBA|Buff |ETX| 
I I |X«F1»| | uar | | 

III II |(4040| | 

i 1 



Read T ext and Read Header Message F orm ats 

The following is representative of typical input-to-processor message 
formats. The format of a multiline read operation follows. 

Read Text Data Stream 

i // // 1 

|Index|STX|CU |Dev|AID|Cursor|SBA|Buff | Text |SBA|Buff| Text | |ETX| 
IByte | |Adr|Adr| | Addr | |Addr| | |Addr| | | | 
" // // J 

Error Status Data Stream 

Another form of input message is the error status message. Error status 
is processed by the DMKRGF module. The characters, %R, following the 
SOH signify that this message contains sense and status data. The 
format of this message follows. 

i 1 

I Index | SOH | % | R |STX|CD |Dev| Sense/|ETX | 
IByte I I I I | ADR | Adr | Status | I 
I I I I I I I IBytes | | 

i 1 



Test Request Data Stream 

The test reguest message, upon receipt from display terminals, is 
ignored by CP. The input inhibit mode that the display terminal enters 
upon pressing the test reguest key can be reset only if the terminal 
user presses the RESET key. The characters, %/, following SOH indicate 
the test reguest function. The format of this message follows. 

, , 

| Index | SOH | % | / | STX | Text | ETX | 
I Byte I I I I I I I 
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ALLOCATION MANAGEMENT 

Real storage space above the Control Program nucleus is made up of the 
dynamic paging area and the free storage area. Page frames (allocation 
space in real storage for a page of data) in the dynamic paging area are 
allocated to virtual machines and the control program to satisfy paging 
requests. Blocks of storage, requested by virtual machines and CP for 
working storage, are allocated from the free storage area. 



NORMAL PAGING REQUESTS 

If a program interruption is caused by a normal paging request (not from 
a virtual machine that is running in EC mode with translation on), 
DMKPRGIN determines whether a segment or page translation error has 
occurred. If one of these errors occurred, an invalid address 
interruption code is set, and the interruption is reflected to the 
virtual machine supervisor. If a segment or page translation error has 
not occurred, the virtual machine's current PSW is updated from the 
program old PSW (PROPSW), the address of the current VMBLOK is placed in 
register 11, and DMKPTRAN is called to obtain the required page. When 
the paging operation is completed, control is returned to DMKDSPCH. 



Virtual Storage Management 

When operating in the CP relocate environment, each virtual machine's 
virtual storage space is described by two sets of tables. 

• One set, the segment and page tables, describes the location and 
availability of any of the virtual machine's virtual pages that may 
be resident in real storage. Locations in these tables are indexable 
by virtual address, and the entries contain index values that 
reference corresponding real storage addresses. In addition, each 
table entry contains an indication of whether the corresponding 
virtual page is available to the user in real storage. These tables 
are referenced directly by the DAT feature when the virtual machine's 
program is running. 

• The second set of tables, called swap tables, is a map of the 
locations of the virtual machine's pages on the DASD devices that 
comprise the system's paging or auxiliary storage. The DASD 
addresses in these tables can either represent the source of a page 
of virtual storage (the location to which a page may be moved if 
necessary) or a dummy address, indicating that the given page has not 
yet been referenced and, thus, has a value of binary zeros. 

The swap tables are arranged in a format indexable by virtual storage 
address. In addition to containing the address of a page, each entry 
contains flags and status bytes that indicate such information as: 

• The storage protection keys to be assigned to the page when it is 
made resident. 

• Whether the page is currently on its way into or out of the system 
(in transit), etc. 

These tables are not referenced directly by the hardware as are the 
page and segment tables, but are used by paging management to locate 
user pages that are needed to execute a program. 
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Virtual storage management is done by the technique known as demand 
paging. This Beans that a page of virtual storage is not "paged in" from 
its DASD auxiliary storage area until it is needed. CP does not 
deternine the pages reguired by a virtual machine before the virtual 
■achine executes. A demand for a page can be made either implicitly by 
the virtual machine or explicitly by CP. 

• An implicit demand for a page is made when a program attempts to 
reference a page that is not available in real main storage. This 
attempt causes a program interruption with the interruption code 
indicating a page or segment exception. Upon recognition of this 
condition, control is passed to the paging manager to obtain a page 
frame of real main storage and to bring in the desired page. 

• An explicit demand for a page can be made by CP (for example, in the 
course of translating a user's channel program) . If, in the process 
of translation, CP encounters a CCW that addresses a page that is not 
resident in real storage, a call is made to the paging manager to 
make the referenced page resident. 

While the requested page is being fetched, the requesting virtual 
machine is unable to continue execution; however, it may be possible to 
run other tasks in the system, and CP runs these while the needed page 
is being paged in. When the requested page is resident, the virtual 
machine can be run and is dispatched in its turn. 

In addition to demanding pages, virtual machines implicitly or 
explicitly release page frames of their virtual storage space. Part of 
the space may be explicitly released from both real and virtual storage 
via a DIAGNOSE instruction that indicates to the control program those 
page frames that are to be released. An entire virtual storage is 
released when a user loads (via IPL) a new operating system or logs off 
from the system. 

CP also has virtual storage associated with it. This space contains 
CP (some parts of which need not always be resident in real storage) , 
and virtual storage buffers for spooling and system directory 
operations. Although CP makes use of virtual storage space for its 
execution, it does not run in relocate mode. Thus, nonresident modules 
must be completely relocatable. 



Real S torage Management 

Real storage management allocates the system's page frames of real 
storage to satisfy the demands for virtual pages made by the system's 
virtual machines. Efficiency of allocation involves a trade-off; the 
paging manager uses only enough processor time to ensure that: 

• The set of virtual storage pages that are resident represent those 
pages that are most likely to be used. 

• A sufficient number of cycles is available to execute virtual machine 
programs. 

Inefficiency in the first area causes a condition known as thrashing, 
which means that frequently used pages are not allowed to remain 
resident long enough for useful work to be performed by or on them. 
Thrashing could be aggravated by the paging manager's page frame 
selection algorithm or by a dispatcher that attempts to run more tasks 
than the system can handle (the sum of their storage requirements 
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exceeds the real paging space available in the system) . Thus, the 
paging manager must keep statistics on system and virtual machine paging 
activity and make these statistics available to the dispatcher to detect 
and prevent a potential thrashing condition. 

Inefficiency in the second area causes an unacceptable ratio of CP 
overhead to virtual machine program time, and in extreme cases may cause 
CP to use excessive processor time. To understand how allocation is 
determined by CP, the way in which the inventory of real storage page 
frames is described to the system must be understood. 

Each page frame (4096-byte block) of real storage in the system is in 
one of two basic states: nonpageable or pageable. A nonpageable page 
must remain resident in real storage for some period of time; thus, the 
page frame cannot be taken from its current owner to be given to someone 
else. Pages can be either permanently or temporarily nonpageable, 
depending upon their use. 

Temporary locks usually occur when an I/O operation has been 
initiated that is moving data either to or from the page, and the page 
must be kept in real storage until the operation has completed. 

A page can also be temporarily nonpageable if it contains an active 
nonresident CP routine. 

In addition, a page can be nonpageable through use of the LOCK 
command. Pages locked this way are permanently resident until they are 
explicitly unlocked by the UNLOCK command. Pages that are usually 
considered permanently nonpageable are those that contain the resident 
portion of CP and those that contain the system's free storage area in 
which control blocks, I/O buffers, etc., are built. 

The data area that page management routines use to control and 
allocate real storage is the CORTABLE. Each page frame of real storage 
has a corresponding entry in the CORTABLE, and because the table entries 
are fixed in length and contiguous, the entry for any given real page 
frame may be located directly by indexing into the table. Each entry 
contains pointers that indicate both the status and ownership of the 
real page that it represents. Some pointers link page table and swap 
table entries to the real page (and thus establish ownership) , while 
others link the entry into one of several lists that the paging routines 
use to indicate the page frame's status and availability for paging. A 
given CORTABLE entry may appear on either of two lists if its real page 
frame is available for paging; however, if the page referenced is locked 
or is in transit, its entry is not in either list and is not referenced 
when available page frames are being searched for swap candidates. The 
lists are known as the free list (FREELIST) and the flush list 
(FLDSHLST), and they represent various levels of page frame 
availability. 

• The free list contains page frames that are immediately available for 
assignment to a requesting virtual machine. The virtual storage 
pages for which they were last used have either been released by 
their owners or they have been paged out to auxiliary storage. 
Requests for real storage are always satisfied from the free list. 
If the list has been depleted, the requestor waits until a new page 
frame becomes available as the result of a virtual storage release or 
a swap-out. 

• The flush list contains page frames that belong to those virtual 
machines that have been dropped from an active dispatching queue. The 
flush list is the first place that the page frame selection routine 
looks to find a page to swap out or to assign to the free list for a 
virtual machine that requires real storage space. 
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• The scheduler aids the page selection algorithm by notifying it of 
virtual Machines that are no longer eligible for dispatching (either 
because they have completed or because they are being held suspended 
in the eligible list) . The scheduler calls the page reset routine 
when a virtual machine is dropped from a queue and does not 
immediately reenter the dispatch list. Under heavy paging loads, it 
is the responsibility of the page reset routine to group all 
in-storage virtual pages belonging to the virtual machine on an 
available (or flush) list for easy selection by the page replacement 
algorithm. 

Requests for Real Storage Page Frames 

Requests for real storage fall into two general categories; those that 
are requesting space for a page of virtual storage, and those (such as 
requests for CP work space) that need page frames for their own use. The 
former, more general case is discussed first, because the latter case is 
a subset of the first. 

The main page manager routine, DHKPTRAN, maps a request for a 
specific virtual storage address into a page frame of real storage. 
This requires that the virtual page be read in and the necessary tables 
be updated to show the proper status of the page frame. 

DHKPTRAN requires that the caller supply only the virtual address to 
be translated and any options that apply to the page to be located. 
Host calls are made via the TRANS macro, which sets up the necessary 
parameters, determines whether or not the required page is resident, and 
calls DHKPTRAN if it is not. 

When DHKPTRAN receives control, it first tests to see if the 
requested page is resident. This is done via the LRA instruction. If 
the page is resident, the routine locks the page if requested and exits 
to the caller. If the LRA indicates that the page is unavailable, it is 
still possible that the required page is resident. This occurs if the 
page frame has been placed on the FREELIST but has not been assigned to 
another virtual machine. When the page swap routine removes a page 
frame from a virtual machine, the unavailable bit is set in the 
corresponding page table entry; however, the real main storage index for 
the page frame is left unchanged. The page table entry is set to zero 
only when the corresponding page is actually assigned to another virtual 
machine. Thus, if DHKPTRAN finds the page unavailable, a further test 
is made on the page table entry to see if the page can be reclaimed. If 
the entry is not zero (aside from the unavailable bit) , the CORTABLE 
entry for the page frame is removed from the FREELIST and the page frame 
is returned to the calling virtual machine. 

If the page table entry corresponding to the requested virtual page 
is zero, the required page is not in real storage and must be paged in. 
However, it is possible that the page is already on its way into main 
storage. This condition is indicated by a flag in the SHPTABLE entry for 
the virtual page. The DHKPAGIO routine maintains a queue of CPEXBLOKs to 
be dispatched when the pending page I/O is complete. The CPEXBLOK for 
the page in transit is located and a new CPEXBLOK, representing the 
current request, is chained to it. 

Before exiting to wait for the paging operation to complete, DHKPTRAN 
checks to see if the deferred return (DEFER option) has been specified. 
If it has not, DHKPTRAN returns to the caller. If the DEFER option has 
been requested, DHKPTRAN exits to the dispatcher to wait for page I/O 
completion. When the requested page has been read into real storage, the 
list of CPEXBLOKs are unstacked first in first out to satisfy all 
requests for the page that arrived while it was in transit. 
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If a page is not in transit, a page frame of real storage must be 
allocated to fill the request. Before the allocation routine is called, 
a test is made to see if the caller wishes the return to his routine or 
to be delayed until after the requested page is available. If the DEFER 
option is not requested, DHKPTRAN returns to the caller after first 
building and stacking a CPEXBLOK that allows processing of the page 
request to be continued the next time the dispatcher (DHKDSPCH) is 
entered. 

DMKPTRAN next calls the FREELIST manager (DHKPTRFR) to obtain the 
address of the next available CORTABLE entry. DHKPTRFR maintains a 
first- in- first- out list of the CORTABLE entries for those page frames 
that are immediately available for assignment. As DHKPTRFR releases 
these page frames, a check is made to see if the number of entries on 
the FREELIST has fallen below a dynamically maintained minimum value. If 
it has, the page selection routine (SELECT) is called to find a suitable 
page frame for placement in the FREELIST. The number maintained as the 
FREELIST threshold has a value equal to the number of users in queue 1 
plus the number of users in queue 2 plus 1. 

The FREELIST is replenished directly by users releasing virtual 
storage space. The page-out routine, DHKPGSPO, calls DHKPTRFT to place 
released page frames directly on the FREELIST. However, most 
replenishment is done via the page selection routine, SELECT. SELECT is 
called by DHKPTRFR when the FREELIST count falls below the current 
minimum, or when a user page is reclaimed from the FREELIST. In either 
case, the selection algorithm attempts to find a page to swap to 
auxiliary storage. The highest- priority candidates for a swap are those 
page frames whose CORTABLE entries appear on the FLUSHLST. SELECT 
attempts to take a flushed page frame before it takes a page frame from 
an active user. If such a page frame is found, it is checked to see if 
it has been changed since page-in. If it has not, it is placed in the 
FREELIST by DHKPTRFT; otherwise, it is scheduled for a swap-out by 
dequeuing the CORTABLE entry from the FLUSHLST, constructing a CPEXBLOK 
for dispatching after I/O completion, and exiting to DHKPAGIO by a GOTO. 
After the paging I/O is complete, the entry is placed on the FREELIST 
via a call to DHKPTRFT. 

If no pages are found on the FLUSHLST, the selection algorithm 
examines each page in real storage, searching for an available page that 
does not have its reference bit od= It begins the search at the first 
available page at the high end of real storage and searches by 
descending page address. When it reaches the lowest available page 
address, it starts again from the top of storage. When a page has been 
found, that page address minus one is checkpointed. The next time the 
selection algorithm is invoked, it starts from the checkpointed address. 
As the selection process proceeds, those pages that were not selected 
have their reference bits turned off. When the selection algorithm is 
operating in this mode, a virtual page must be referenced at least once 
per reset cycle (loop around real storage) to avoid selection. 

Once a page frame has been selected and page-out is scheduled, 
control is returned to DHKPTRFR, which then passes control back to 
DHKPTRAN with the address of the CORTABLE entry that was allocated. In 
most cases, page- outs are completely overlapped with page-ins. 
Approximately one half of all page-ins require a corresponding page-out. 

Once a page frame has been assigned, DHKPTRAN checks to see if a 
page-in is required. It usually is, and the DASD address of the virtual 
storage page must be obtained from the user's swap table entry and the 
I/O operation scheduled. However, if the page frame has not yet been 
referenced (as indicated by a DASD address of zero) , the real main 
storage page frame is set to zero, and no page-in is required. After 
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the page-in operation has been queued, DMKPTRAH exits to the paging I/O 
scheduler (DMKPAGIO), which initiates the paging operation and exits to 
the dispatcher (DMKDSPCH) to await the interruption. 

Some requests for main storage page frames are handled differently 
from general virtual- to- real storage mapping. In particular, it may be 
necessary for CP to obtain additional free storage for control blocks, 
I/O lists, buffers, etc. This is handled by the free storage manager, 
which makes a direct call to DMKPTRFR to obtain the needed storage. 
Usually, this storage is immediately available (due to the page 
buffering technique previously described) . However, if the FREELIST is 
exhausted, the request for free storage is recognized as a high-priority 
call and queued first on the list of those waiting for free page frames. 

The real storage manager (DMKPTR) accumulates paging statistics that 
the scheduler (DMKSCH) uses to anticipate user storage requirements. A 
count of page-reads and page-writes is kept in each virtual machine's 
VMBLOK; the corresponding total counts for the system are kept in 
DMKPSA. A running total of the number of pages a virtual machine has 
resident, at each instance of page- read, is kept in the VHBLOK. A count 
of the number of times a virtual machine enters page-wait, because a 
page frame has been stolen from it, is also kept in the VHBLOK. The 
section entitled "Controlling Multiprogramming 1 * under "Dispatching and 
Scheduling" describes the use to which the scheduler puts these counts. 

VM/370 Virtual= Real Option: The VM/370 virtual=real option involves the 
mapping in a one- for- one correspondence of a virtual machine storage 
area with an equivalent real storage area. For instance, virtual page 1 
is in real page frame 1 and virtual page 20 is in real page frame 20. 
Virtual page is relocated at the end of the virtual storage space 
because it cannot occupy real page frame 0. 

The CP nucleus is altered at system generation to support the 
virtual=real option. Virtual machines with virtual=real (specially 
identified in the directory) can then log on and use the space reserved 
for this option. That space can be used by only one virtual machine at a 
time. Two virtual machines with the virtual=real capability cannot 
occupy the same space at the same time. 

The virtual=real option allows the virtual machine to bypass the 
control program's CCW translation. This is possible because I/O from a 
virtual machine occupying a virtual=real space contains a list of CCWs 
whose data addresses reflect the real storage addresses. The 
restriction in this situation is that the virtual machine does not 
perform I/O into page frame because this would perform a data transfer 
into real page frame 0. At the same time, it is assumed, and cannot be 
checked, that the virtual machine also does not attempt to do I/O beyond 
the bounds of its virtual addressing space. To do so would cause the 
destruction of either the CP nucleus, which resides beyond the virtual 
machine space, or another user's page. 

If the real I/O device is an MSS 3330V, then CCW translation is not 
bypassed since CP must still be able to recognize an MSS cylinder fault. 
See Appendix B for details. 

The bypassing of CCW translation for the virtual machine occupying 
the virtual=real space is only invoked after the virtual machine has 
executed the SET NOTRANS ON command. This command can only be issued by 
the virtual machine occupying the virtual=real space. The command 
initiates the bypass of CCW translation. This option is automatically 
turned off if the virtual machine performs an explicit reset or an 
implied reset by performing a virtual IPL. During virtual machine IPL, 
I/O must be performed into page frame 0. For this reason, normal 
virtual IPL simulation assumes CCW translation in effect to accomplish 
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the full simulation. Once the IPL sequence has completed, CCW 
translation can be bypassed by issuing the SET NOTRANS ON command. 

When the virtual machine demands a page frame through normal use of 
CP*s page tables, the paging routine recognizes the virtual=real 
capability. It then assigns the virtual page to the equivalent real page 
frame and does not perform a paging operation, because all these pages 
are resident and are never swapped out. 

Note: The virtual machine running with virtual=real is still run in 
System/370 relocate mode. 

Virtual 270X lines and sense operations from the virtual machine do 
not use the virtual=real function. These invoke CCW translation for the 
virtual enable/disable lines and the transfer of the sense bytes. 

The DNLOCK command has a VIRT=REAL operand that essentially releases 
the virtual=real area for normal system paging use. Once the area has 
been released, it can only be reclaimed for additional virtual=real 
operations only by an IPL of the VM/370 system. The size of the 
virtual=real area is an installation specification that is part of the 
special nucleus generation procedure that is outlined in the VM/370 
Planning and Sys tem Generation Guide. The size of the area must be 
large enough to contain the entire addressing space of whatever virtual 
machine wishes to occupy that space. A virtual machine can use a smaller 
space than is provided but cannot use a larger space without 
regenerating the CP nucleus. 

DASD STORAGE MANAGEMENT 

Any virtual machined virtual storage pages that have been referenced 
but are not resident in real storage must be kept in slots on the DASD 
paging device. DASD page space is assigned only when the page is 
selected for a page- out. Certain DASD pages may also be marked 
read-only. Thus, the DASD address slot initially associated with the 
page should be considered to be the source of the page only. If the 
page is changed after it has been read into real storage, a new slot 
must be obtained when it is paged out. Examples of read-only pages are 
those which contain portions of pageable saved systems and pages which 
are part of a system spool file. Slots can be reassigned when DMKPTRAN 
finds that it must swap a page out to a movable-head DASD device. In 
this case, the old slot is released and the new slot is obtained. 



S lot Allocation 

If a new slot is required, DMKPGT is called to supply the address of an 
available slot. DMKPGT maintains a chain of cylinder allocation maps for 
each cylinder that has been assigned for either virtual storage or spool 
file paging. The allocation chains for spooling are kept separately 
from those used for paging so that they can be checkpointed in case of a 
system failure. However, in other respects they are the same. The 
allocation blocks for a given volume are chained from the RDEVBLOK for 
the device on which the volume is mounted. The chains of cylinder and 
slot allocation blocks are initialized by DMKCPI. Each block on an 
allocation chain represents one cylinder of space assigned to paging, 
and contains a bit map indicating which slots have been allocated and 
which are available. Each block also has a pointer to the next 
allocation block on the chain, a cylinder number, and a record count. 
DMKPGT searches this list sequentially until an available slot is found; 
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its DASD address is then determined and passed back to the calling 
routine, if DMKPGT cannot find a cylinder with a de-allocated slot, it 
enters the cylinder allocation phase. When an available cylinder is 
found, it constructs a page allocation block for this cylinder and 
allocates a page to the caller. 



Cylinder Allocation 

DMKPGT controls the paging and spooling I/O load of the system by 
allocating cylinders evenly across all available channels and devices. 
In order for a device to be considered available for the allocation of 
paging and spooling space: 

• Its volume serial number must appear in the system's owned list. 

• It must have at least one cylinder of temporary space marked as 
available in the cylinder allocation block which is located on 
cylinder 0, head 0, record 3. 

• It must not be an HSS 3330V volume. 

At system initialization time, CPINIT reads in the allocation records 
for each volume and constructs the chains of device allocation blocks 
from which DMKPGT allocates the cylinders. In managing the cylinder 
allocation, DMKPGT takes three factors into consideration: device type, 
device address, and possible status as a preferred paging device. 

A request for a cylinder of virtual storage page space is satisfied 
by allocating space on a preferred paging device, provided that one 
exists on the system and that it has page space available. Preferred 
paging devices are specified by the installation at system generation 
time, and generally should be devices on which excessive seek times do 
not occur. A typical preferred paging device would be the IBM 2305 
Fixed Head Storage facility. If the 2305 is assigned as a preferred 
device, it is possible to allocate some of its space for other 
high-priority data files without excessively degrading paging. An 
example of such usage would be for high activity read-only saved system 
pages that are not shared in real storage, and high-activity system 
residence disks. 

It is also possible to designate movable-head DASD devices such as 
the 3330, 3340, 3350 and 2314/2319 Direct Access Storage facilities as 
preferred paging devices. The module (s) so designated should not be 
required to seek outside of a relatively narrow cylinder band around the 
center of the paging areas. It is advisable to share the access arm of 
a movable-head preferred paging device with only the lowest-usage data 
files. 

If one or more preferred devices are defined on the system, CP 
allocates all of the page space available space on these before it 
allocates on any other available owned volumes. Within the class of 
preferred devices, space is allocated first on the fastest devices, and 
these are spread out across channels and devices. Allocation on 
nonpref erred devices is spread out in the same manner. Cylinders for 
spooling space are not allocated from preferred devices. Allocation on 
a given device is done from the relative center of the volume outward, a 
cylinder at a time in a zig-zag fashion in an attempt to minimize seek 
times. 
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When a request to allocate a slot for virtual storage paging is 
received by DMKPGTGT and the slot must be allocated on a moveable head 
(2314/2319, 3330, 3340, or 3350) device, a cylinder and slot are 
selected in the following manner: 

1. CP tries to allocate a space on the cylinder at which the arm on 
the selected device is currently positioned. 

2. If slots are not available on the current cylinder, CP tries to 
allocate space on a cylinder for which paging I/O has been queued. 

3. If the above conditions cannot be met, CP allocates space as close 
to the center of the volume as is possible. 

Before DMKIOSQR is called, the queue of IOBLOKs currently scheduled 
on the device is examined. If paging I/O has already been scheduled on 
a device, the paging channel programs are slot-sorted and chained 



PAGING I/O 

DMKPAGIO handles all input/output requests for virtual storage and 
spooling pages. DMKPAGIO constructs the necessary task blocks and 
channel programs, expands the compressed slot addresses, and maintains a 
queue of CPEXBLOKs for pages to be moved. Once the I/O scheduled by 
DMKPAGIO completes, it unchains the CPEXBLOKs that have been queued and 
calls DMKSTKCP to stack them for execution. DMKPAGIO is entered by a 
GOTO from: 

• DMKPTRAN to read and write virtual storage pages 

• DMKRPA to read and write virtual storage spool buffers 



In either case, all that needs to be passed to DMKPAGIO is the 
address of the CORTABLE entry for the page that is to be moved, the 
address of a SWPTABLE entry for the slot, a read or write operation 
code, and the address of a CPEXBLOK that is to be stacked for 
dispatching after the I/O associated with the page has completed. 
DMKPAGIO obtains an IOBLOK and builds a channel program to do the 
necessary I/O, and uses the device code that is part of the page address 
to index into the system's OWNDLIST and locate the real device to which 
the I/O request should be directed. If the device is capable of 
rotational position sensing, the required sector is computed and a SET 
SECTOR command is inserted into the channel program. The real SIO 
supervisor DMKIOSQR is then called to schedule the operation on the 
proper device. 

When the interruption for the paging operation is processed by the 
primary I/O interruption handler, the IOBLOK that controls the operation 
is unstacked to the interruption return address, waitpage, in DMKPAGIO. 
waitpage then unchains the CPEXBLOKs that are queued to DHKPAGQ, and 
then stacks the queued CPEXBLOKs, by calls to DMKSTKCP, in the order in 
which they were received. The address of the real page frame is filed 
into the appropriate page table entry and the pointers denoting the 
ownership of the real page frame are filed into the CORTABLE entry by 
the processing routines in DMKPTRAN. If a fatal I/O error occurred for 
the related page frame, the CPEXBLOKs associated with it are flagged, 
and the dispatcher, DMKSDPCH, sets a nonzero condition code when it 
activates the pending task. The error recovery followed depends on the 
operation being performed. Paging I/O errors associated with spooling 
operations are discussed in "DASD Errors During Spooling" in this 
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section, while errors associated with virtual storage paging operations 
are discussed later in the section "Virtual Storage Paging Error 
Recovery". 

DMKPAGIO maintains its own subpool of Preformatted paging IOBLOKs. 
As I/O operations complete, their IOBLOKs are added to a list of 
available blocks; as new blocks are needed, they are taken from this 
list. If the list is empty, DMKFREE is called to obtain storage for a 
new block. DMKPAGIO also periodically calculates system paging 
overhead. After 200 pages have been moved (read or written) , the 
elapsed time for the 200 page moves is computed, and the paging rate is 
calculated in page moves per second. The recent paging load, expressed 
as the percentage of time that more than one half of the system's pages 
were idle due to page-wait, is averaged with the previous load and 
re-projected as the expected load for the next interval. 



I PAGING SUBSYSTEM 

I The paging subsystem has three major components that have resource 

| optimization algorithms associated with them: 

I • The page replacement and page selection algorithm that manages the 
| allocation of real storage frames and selects which virtual page to 
| replace. 

I • An algorithm for the allocation of DASD backing store pages. 

I • An algorithm for ordering the gueue of page I/O regests. 



| PAGE REPLACEMENT AND PAGE SELECTION ALGORITHM 

7M/370 is a demand paging system. Programs run in virtual storage and 
when a storage reference is made to a virtual page not currently in real 
storage, a page fault occurs. A page fault is a program interruption 
that occurs when a page marked "not in real storage" is referred to by 
an active page. This page fault represents a demand for a real storage 
frame in which to place the virtual page. The page replacement 
algorithm chooses which real storage frame will be allocated to fulfill 
such a demand. If all real frames in real storage are occupied by other 
virtual pages, a real frame can only be obtained by replacing one of 
those virtual pages. The selection of which virtual page to replace is 
carried out by the page selection algorithm. 

The scheduler aids the page selection algorithm by notifying it of 
virtual machines that are no longer eligible for dispatching (either 
because they have been dispatched, or because they are being held 
suspended in the eligible list) . The scheduler calls the page reset 
routine when a virtual machine is dropped from a gueue and reset routine 
when a virtual machine is dropped from a gueue and does not immediately 
reenter the dispatch list. Under heavy paging loads, it is the 
responsibility of the page reset routine to group all in-storage virtual 
pages belonging to the virtual machine; it groups them on an available 
(or flush) list for easy selection by the page replacement algorithm. 

The page reset routine cycles through the virtual machine's segment 
table looking for valid segment entries. When it finds a valid entry, 
it turns on the segment table entry invalid flag and the page reset 
i routine begins to process the page table associated with that segment 
I table entry. The page table header is timestamped, and if it is a 
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shared segment, the active segment table entry count is decreased. For 
a shared segment, if the active count is still greater than zero, no 
further processing is done. If the count has decreased to zero, for a 
shared segment, processing continues as if it were a private segment. 
Each page table entry in a segment is then examined for an in-storage 
page. If one is found, it has its reference bit reset to zero. In 
addition, if the heavy paging condition flag has been set, the page 
table entry is marked invalid, and the real page is placed on the flush 
list in last- in-first- out order. 



I Page Selection 

The page replacement/page selection algorithm must find a real frame to 
satisfy a demand for a virtual page. It first attempts to satisfy the 
demand with a page from the flush list. The flush list contains virtual 
pages (if any) that belong to virtual machines that are not eligible for 
dispatching, and therefore are not being used. 

Note : A virtual machine may reenter the dispatch list after its pages 
have been placed on the flush list. If the virtual machine attempts to 
access any of those pages, they will be reclaimed. The pages are placed 
on the flush in last- in- first- out order under the assumption that the 
longer they remain on the list, the higher the probability the virtual 
machine will reenter the dispatch list and reclaim them. 

If no pages are found on the flush list, the selection algorithm 
examines each virtual page in real storage, searching for an available 
page that does not have its reference bit on. It begins the search at 
the first available virtual page at the high end of real storage and 
searches by descending page address. When it reaches the lowest 
available page address, it starts again from the top of storage. When a 
page has been found, that page address minus one is checkpointed. The 
next time the selection algorithm is invoked, it will start from the 
checkpointed address. As the selection process proceeds, those pages 
that were not selected have their reference bits turned off. When the 
selection algorithm is operating in this mode, a virtual page must be 
referenced at least once per reset cycle (loop around real storage) to 
avoid selection. 



I BACKING STORE ALLOCATION ALGORITHM 

I There are two parts to the algorithm for allocation of a DASD page 

| record. The first is to find the optimal device on which to allocate a 

j record. The second is then to optimize the record allocation on a 

I particular device. 

I Device Selection 

I CP maintains the DASD device chain in two parts. The major part is the 

I ordering of all devices by type and by the TEMP/PAGE classification. 

I All PAGE devices are ordered before all TEMP devices. The device type 

I ordering is: 2305, 3350, 3340, 3330, and 2314. All devices of the same 

I type are chained together off the primary chain. CP attempts to 

I allocate a page record on the highest- level device until all devices at 

I that level are full and then it tries the next lower device type. 

I Within a particular device type, CP allocates records in a round-robin 

I manner, attempting to evenly distribute the allocated records. 
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C ylin der Selection 

Once a device is selected, CP must determine on which cylinder to 
allocate a record on that device. CP maintains a chain of cylinder 
record maps, one for each alloca table cylinder on the device. For 2305 
devices, CP attempts to keep cylinder map blocks at the head of the 
chain. The only optimization done for a 2305 is an attempt to minimize 
the amount of processor time involved in the allocation process. For 
movable-arm DASD (that is, not 2305) , CP attempts to allocate the first 
available record found when scanning the cylinder map chain. 



I £aqe Selection Routine Supp ort 

Whenever a changed page is selected for replacement, it must first be 
copied onto DASD before the real page can be made available. In cases 
where there is already a DASD record allocated for the page and it is on 
a movable-arm DaSD, the page selection routine deallocates Llie ulu 
record and requests that a new record be allocated . This occurs each 
time a page is to be written and its current backing-store location is 
on a movable-arm DASD. Although this represents overhead in terms of 
processor use, it is justified because it should minimize arm movement 
and reduce page wait time. 



| PAGE I/O REQUEST QOEUEING ALGORITHM 

The ordering of page I/O requests that are chained together for 
initiation with one SIO is done on a priority ordering basis. The 
priority is: 

1. In- queue requests 

2. Not-in- queue requests 

3. Reads 

4. Writes 

5. Q1 requests 

6. Q2 requests 

PCI flags are set for page I/O requests. For non-2305 requests, there 
is an interruption after each request. For 2305 requests, the PCI flag 
is set so that there is one interruption for each revolution of the drum 
(one interruption for every three requests) . 

Note ; For installations that are much more constrained by a page I/O 
bottleneck (as opposed to processor bottleneck) , the 2305 PCI mode can 
be changed to operate in the same way as the non-2305 processing, that 
is, by allowing an interruption immediately after each request. The SET 
SRM PCI DISK command causes the PCI flag to be set so there is one 
interruption for each 2305 page request. SET SRM PCI DRUM changes it 
back to the default mode of operation. 



VIRTUAL STORAGE PAGING ERROR RECOVERY 

Errors encountered during virtual storage (as opposed to spooling) 
paging operations can generally be classified as either soft or hard 
errors. Soft errors allow the system to continue operation without delay 
or degradation. Hard errors can cause noticeable effects such as the 
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abnormal termination of user tasks (abend) and response degradation. 
Errors that are successfully retried or corrected are known only to the 
I/O supervisor and the I/O error retry and recording routines; they 
appear to the second level interruption handlers (such as WAITPAGE) as 
if the original operation completed normally. 

SOFT ERROR RECOVERY: In I/O error that occurs on a page swap-out is 
considered to be a soft error. DMKPTRAN calls DMKPGTPG to assign a 
different DASD page slot and the page is re-queued for output. The slot 
that caused the error is not de-allocated, and thus is not assigned to 
another virtual machine. All other uncorrectable paging errors are hard 
because they more drastically affect system performance. 

H ARD ERROR RECOVERY: Hard paging errors occur on either I/O errors for 
page reads or upon exhausting the system's spooling and paging space. 
Recovery attempted on hard errors depends upon the nature of the task 
for which the read was being done. If the operation was an attempt to 
place a page of a virtual machine's virtual storage into real storage, 
the operation of that particular virtual machine is terminated by 
setting the page frame in error to zero and placing the virtual machine 
in console function mode. The user and operator are informed of the 
condition, and the page frame causing the error is not de-allocated, 
thereby ensuring that it is not allocated to another user. 

The control program functions that call DMKPTRAN (such as spooling, 
pageable control program calls, and system directory management) have 
the option of requesting that unrecoverable errors be returned to the 
caller. In this case, the CP task may attempt some recovery to keep the 
entire system from terminating (abend) . In general, every attempt is 
made to at least allow the operator to bring the system to orderly 
shutdown if continued operation is impossible. 

Proper installation planning should make the occurrence of a space 
exhaustion error an exception. An unusually heavy user load and a 
backed-up spooling file could cause this to happen. The operator is 
warned when 90% of the temporary (paging/spooling) space in the system 
is exhausted. He should take immediate steps to alleviate the shortage. 
Possible remedies that exist include preventing more users from logging 
on and requesting users to stop output spooling operations. More drastic 
measures might include the purging of low-priority spool files. If the 
system's paging space is completely exhausted, the operation of virtual 
machines progressively slows as more and more users have paging requests 
that cannot be satisfied and operator intervention is required. 



VIRTUAL RELOCATION 

CP provides the virtual machine the capability of using the DAT feature 
of the real System/370. Programming simulation and hardware features 
are combined to allow usage of all of the available features in the real 
hardware, (that is, 2K or UK pages, 64K or 1M segments) . 

For clarification, some term definitions follow: 

First-level sto rage : The physical storage of the real CPO, in which CP 
resides. 

Se con d-level storage: The virtual storage available to any virtual 
machine, maintained by CP. 
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Third- level storage; The virtual storage space defined by the system 
operating in second- level storage, under control of page and segment 
tables which reside in second- level storage. 

P age and segment tables; Logical napping between first-level and 
second- level storage. 

Vi rtua l page and seq me nt tables; Logical mapping between second-level 
and third- level storage. 

Shadow page and seg ment tables; Logical mapping between first-level 
storage and third- level storage. 

A standard, nonrelocating virtual machine in CP is provided with a 
single control register, control register zero that can be used for: 

• Extended masking of external interruptions 

• Special interruption traps for SSM 

• Enabling of virtual block multiplexing 

A virtual machine that is alloiieu to use the extended control feature 

of System/370 is provided with a full complement of 16 control 

registers, allowing virtual monitor calls, PER, extended channel 
masking, and dynamic address translation. 

An extension to the normal virtual-machine VMBLOK is built at the 
time that an extended control virtual machine logs onto CP. This EGBLOK 
contains the 16 virtual control registers, 2 shadow control registers, 
and several words of information for maintenance of the shadow tables, 
virtual CPU timer, virtual TOD clock comparator, and virtual PER event 
data. The majority of the processing for virtual address translation is 
performed by the module DMKVAT, with additional routines in DMKPBG, 
DMKPRV, DMKDSP, DHKCDB, DHKLOG, DMKUSO, and DMKPTR. The simulation of 
the relocation-control instructions (that is, LCTL, STCTL, PTLB, RRE, 
and LRA) is performed by DMKPRV. These instructions, with the exception 
of LCTL and STCTL, are not available to virtual machines which are not 
allowed the extended control mode. 

When an extended-control virtual machine is first active, it has only 
the real page and segment tables provided for it by CP and operates 
entirely in second- level storage. DMKPRV examines each PSfl loaded via 
LPSW to determine when the virtual machine enters or leaves extended 
control or translate mode, setting the appropriate flag bits in the 
VMBLOK. Flag bits are also set whenever the virtual machine modifies 
control registers or 1, the registers that control the dynamic address 
translation feature. DMKDSP also examines PSWs that are loaded as the 
result of interruptions to determine any changes in the virtual 
machine* s operating mode. The virtual machine can load or store any of 
the control registers, enter or leave extended control mode, take 
interruptions, etc., without invoking the address translation feature. 

If the virtual machine, already in extended control mode, turns on 
the translate bit in the EC mode PSW, then the DMKVATMD routine is 
called to examine the virtual control registers and build the reguired 
shadow tables. (Shadow tables are reguired because the real DAT hardware 
is capable of only a first- level storage mapping.) DMKVATMD examines 
virtual control registers and 1 to determine if they contain valid 
information for use in constructing the shadow tables. Control register 
zero specifies the size of the page and segment the virtual machine is 
using in the virtual page and segment tables. The shadow tables 
constructed by DMKVATMD are always in the same format as the virtual 
tables. 
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The shadow segment table is constructed in first-level storage and 
initialized to indicate that all segments are unavailable. Flags are 
maintained in the VMBLOK to indicate that the shadow tables exist. 
DMKVATMD also constructs the shadow control registers and 1. Shadow 
control register contains the external interruption mask bits used by 
CP, mixed with the hardware controls and enabling bits from virtual 
control register 0. Shadow control register 1 contains the segment 
table origin address of the shadow segment table. 

When the virtual machine is operating in virtual translate mode, CP 
loads the shadow control registers into the real control registers and 
dispatches the user. The immediate result of attempting to execute an 
instruction is a segment exception, intercepted by DMKPRG and passed to 
DMKVATSX. DMKVATSX examines the virtual segment table in second-level 
storage. If the virtual segment is not available, the segment exception 
interruption is reflected to the virtual machine. If the virtual 
segment is marked available, then DMKVATSX: 

• Allocates one full segment of shadow page table, in the format 
specified by virtual control register 0. 

• Sets all of the page table entries to indicate page not in storage. 

• Harks the segment available in the shadow segment table. 

• Redispatches the virtual machine via DMKDSP. 

Once again, the immediate result is an interruption, which is a 
paging exception and control is passed to DMKVATPX. DMKVATPX references 
the virtual page table in second- level storage to determine if the 
virtual page is available. If the virtual page is not available, the 
paging interruption is reflected to the virtual machine. However, if 
the virtual page is marked in storage, the virtual page table entry 
determines which page of second- level storage is being referenced by the 
third- level storage address provided. DMKVATPX next determines if that 
page of second- level storage is resident in first-level storage at that 
time. If so, the appropriate entry in the shadow page table is filled 
in and marked in storage. If not, the required page is brought into 
first-level storage via DMKPTRAN and the shadow page table filled in as 
above. 

As the virtual machine continues execution, more shadow tables are 
filled in or allocated as the third-level storage locations are 
referenced. Whenever a new segment is referenced, another segment of 
shadow page tables is allocated. Whenever a new page is referenced, the 
appropriate shadow page table entry is validated, etc. No changes are 
made in the shadow tables if the virtual machine leaves translate mode 
(usually via an interruption) , unless it also leaves extended control 
mode. Dropping out of EC mode is the signal for CP to release all of the 
shadow page and segment tables and the copy of the virtual segment 
table. 

There are some situations that require invalidating all of the shadow 
tables constructed by CP or even releasing and reallocating them. 
Whenever DMKPTR swaps out a page that belongs to a virtual relocating 
machine, it sets a bit in the VMBLOK indicating that all of the shadow 
page tables lust be invalidated. Invalidation of all of the tables is 
required since CP does not know which third-level storage pages map into 
the second-level page that is being swapped out. The actual 
invalidation is handled by DHKVATAB, called from DMKDSP when the virtual 
machine is on the verge of being dispatched. 
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The other situations which cause shadow table invalidation arise from 
the simulation of privileged instructions in DMKPRV. Flags are set in 
the VMBLOK whenever the virtual machine loads either control register 
or 1, and DMKPRV calls DMKVATAB to perform whatever maintenance is 
required. When control register 1 is loaded by the virtual machine, 
DMKVATAB must re-copy the virtual segment table into first-level storage 
and invalidate the entire shadow segment table. When control register 
is loaded, DMKVATAB examines the relocation-architecture control bits to 
determine if they have changed, (such that the format of the virtual 
page and segment tables no longer matches that of the shadow tables) . If 
the format has not changed, the shadow tables are left intact; 
otherwise, all of the shadow tables must be returned to free storage and 
another set, in the new format, must be allocated and initialized. The 
same actions can result from modifying the control registers via the CP 
console functions, in which case DMKVATAB is called from DMKCDB. The 
privileged operation, PTLB, also causes the virtual segment tables to be 
re-copied and all of the shadow page tables to be invalidated because 
the shadow tables are the logical equivalent of the translation 
look-aside buffer. 

DMKPRV provides virtual interrogation of the reference and change 
bits in the virtual storage keys, which involve the privileged 
instructions ISK, SSK, and RRB. The privileged instruction LRA is 
simulated via DMKVATLA, which searches the virtual page and segment 
tables to translate a third- level storage address to a second-level 
storage address, returning a condition code indicator to DMKPRV, or 
forcing an interruption if the tables are incorrectly formatted. 

Most error situations that occur in the virtual machine are handled 
by means of the extended program interruptions associated with the real 
address translation hardware. Whenever a virtual relocating machine 
loads control registers or 1 with an invalid value, DMKVAT releases 
all of the shadow tables exactly as if the hardware controls had 
changed. The shadow control registers are set valid, with the shadow 
segment table re-allocated at a minimum size and all segments marked 
unavailable. Flag bits are set in the VMBLOK to indicate that the 
shadow tables are artificially valid, and DMKVATSX reflects a 
translation specification exception to the virtual machine as soon as it 
is dispatched. While it is possible for the virtual machine to enter an 
interruption loop (if the new PSW is also a translate mode PSW) , the 
cited process prevents the occurrence of a disabled loop within CP, 
which would result if the virtual machine is never dispatched. 



FREE STORAGE MANAGEMENT 

DMKFRE is responsible for the management of free storage, and CP uses it 
to obtain free storage for I/O tasks, CCW strings, various I/O buffers, 
etc. It is used, in fact, for practically all such applications except 
real channel, control unit, and device blocks, and the CORTABLE. 

Block sizes of 30 doublewords or less, constituting about 99 per cent 
of all calls for free storage, are grouped into 10 subpool sizes (3 
doublewords each), and are handled by LIFO (push-down stack) logic. 
Blocks of greater than 30 doublewords are strung off a chained list in 
the classic manner. 
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When subpools are exhausted, small blocks are generally obtained from 
the first larger block at the end of available free storage. Large 
blocks, on the other hand, are obtained from the high-numbered end of 
the last larger block- This procedure tends to keep the volatile small 
subpool blocks separated from the large blocks, some of which stay in 
storage for much longer periods of time; thus, undue fragmenting of 
available storage is avoided. 

DHKFRE initially starts without any subpool blocks. They are 
obtained from DHKFREE and returned to DHKFRET on a demand basis. 

The various cases of calls to DHKFREE for obtaining free storage, or 
to DHKFRET for returning it, for subpool sizes and large sizes, are 
handled as follows: 

Calling DHKFREE for a S ub j>ool 

Subpool Available ; If a call for a subpool is made and a block of the 
suitable size is available, the block found is detached from the chain, 
the chain patched to the next subpool block of the same size (if any) , 
and the given block returned to the caller. 

Subpool Hot A vailable ; If a block of suitable size is not available when 
a call to DHKFREE is made for a subpool, the chained list of free 
storage is searched for a block of equal or larger size. The first block 
of larger or equal storage is used to satisfy the call (an equal-size 
block taking priority) , except that blocks within the dynamic paging 
area are avoided if at all possible. If no equal or larger block is 
found, all the subpool blocks currently not in use are returned to the 
main free storage chain, and then the free storage chain is again 
searched for a block large enough to satisfy the call. If there still is 
no block large enough to satisfy the request, then DHKPTRFR is called to 
obtain another page frame of storage from the dynamic paging area, and 
the process is repeated to obtain the needed block. 

Calling DHKFREE for a L ar qe Blo ck 

If a call to DHKFREE is made for a block larger than 30 doublewords, the 
chained list of free storage is searched for a block of equal or larger 
size. If -an equal-size block is found, it is detached from the chain and 
given to the caller, if at least one larger block is found, the desired 
block size is split off the high- numbered end of the last larger block 
found, and given to the caller. If no equal or larger block is found, 
DHKPTRFR is called to obtain another page frame of storage from the 
dynamic paging area, and the above process is repeated (as necessary) to 
obtain the needed block. 

Calling DHKFRET for a Subpool 

If a subpool block is given back via a call to DHKFRET, the block is 
attached to the appropriate subpool chain on a LIFO (push-down stack) 
basis, and return is made to the caller. If, however, the block was in a 
page within the dynamic paging area, the block is returned to the 
regular free storage chain instead. 
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Calling DMKFRET for a Large Block 

If a block larger than 30 doublewords is returned via DMKFRET, it is 
■erged appropriately into the regular free storage chain. Then, unless 
the block was returned by DMKFRETR (see "Initialization") a check is 
■ade to see if the area given back (after all merging has been done) is 
a page frame within the dynamic paging area. If so, DHKPTRFT returns it 
to the dynamic paging area for subsequent use. 

l£ee Sto rag e Page Frame Allocation 

The number of page frames allocated to free storage depends upon: 

1. The real machine storage size 

2. The RMSIZE operand specified in the SYSCOR macro at system 
generation time 

3 The FREE operand in the SYSCOR macro 

The storage size used by Va/370 is the smaller of the real machine 
storage size and the RMSIZE value. 

If the FREE operand was not included in the SYSCOR macro statement 
for DMKSYS, the default number of fixed free storage pages allocated at 
IPL time for the first 256K of storage is 3 and 1 page for each 64K 
thereafter, not including V=R size, if any. 

If the FREE operand was included in the SYSCOR macro statement for 
DMKSYS, that value is the number of fixed free storage page frames 
allocated at IPL time. If those pages represent an amount of free 
storage greater than 25X of the VM/370 storage size (not including 7=R 
size, if any) the default allocation is used. 

CP INITIALIZATION 

System initialization starts when the operator selects the DASD device 
address of the CP system residence volume (SYSRES) and presses the IPL 
button. The System/370 hardware reads 24 bytes from record 1 of 
cylinder on SYSRES into location of main storage. This record 
consists of an initial PSW and a channel program. The channel program 
reads the module DMKCKP into location X^OO 1 and gives it control. 
DMKCKP checks location CPID in module DMKPSA. 

If CPID contains the value CPCP or HARM, DMKCKP saves the spool file 
control blocks, system log messages, accounting information, status of 
spool devices, spool hold queue blocks, and spool record allocation 
blocks and writes them on the warm start cylinders. If CPID contains 
the value CPCP, DMKCKP loads a disabled wait state code X'008». 

If location CPID does not contain the value CPCP, DMKCKP now loads 
DMKSAV and passes control to it at entry point DMKSAVRS. DMKSAV reloads 
a page image copy of the CP nucleus into real storage starting at page 
0. When DMKSA7 is finished, control is transferred to DMKCPI. DMKCPI 
performs the main initialization function. This includes calling DMKWRM 
to retrieve the information stored on the warm start cylinder. This 
also includes calling DMKCKS to initialize the dynamic checkpoint 
cylinders and to checkpoint the current status of the spool file system. 
When DMKCPI has finished, it passes control to DMKDSPCH. DHKDSPCH loads 
a wait state PSW to wait for work. See "CP Initialization for the 
Attached Processor" for additional information. 
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INITIALIZATION AND TERMINATION 

Attaching a Virtual Machine to the Systea 

After CP has been initialized, DMKCPVEN enables the communication lines 
in response to the ENABLE command. Then an individual virtual machine 
is attached to the system, using the following steps: 

1 . Terminal Identi fication 

When the CP receives the initial interrupt from a terminal on an 
enabled line (normally initiated by a user dialing in on a 
data-set), the DMKCNSIN routine is entered. BMKCNSIN determines 
the terminal device type, stores this information in the terminal 
device block, writes the online message and puts the terminal line 
in a state to receive an attention interruption. 

2. Attention from Dser 

After the online message has been displayed at the user's terminal, 
and he has pressed the ATTENTION key, DMKCNSIN (the console 
interruption routine) calls DMKBLDVH to build a skeleton VMBLOK for 
the user. At this time, the userid is LOGONxxx, where xxx is the 
terminal real device address, and a flag is set to indicate that 
the user has not yet completed the logon process. 

Then DMKCNSIN calls DMKCFMBK, which types a single blank at the 
terminal, and issues a read to the terminal for the user to enter 
his first command (normally LOGON or DIAL) . 

3 - F irst Comman d f rom User 

After the first command has been entered by the user, DMKCHSIN 
further determines the type of terminal. If the terminal is a 
2741, DMKTRMID is called to identify it as either a 2741P 
(PTTC/EBCD) or a 2741C (Correspondence) terminal. If successful, 
the correct device type and translate tables for input and output 
are set; if not, flags are set to indicate that the terminal is 
not yet identified. 

Then control is returned to DMKCFMBK, which determines if the first 
command is valid (for example, LOGON, MSG, or DIAL). If the first 
command is not valid, a restart message is given, and the read to 
the terminal occurs again for the first command. If the first 
command was LOGON (or its abbreviation) , DMKLOGON is called to 
complete the process of attaching the virtual machine to the 
system. 

The operations performed by DMKLOGON include the following: 

• Ensures that the maximum number of virtual machines allowed on 

the system is not being exceeded. 

• Obtains the userid from the command line, and checks for a 
possible password and other optional operands. 

• Checks the userid and password (entered separately if not on the 
LOGON command line) against entries in CP*s directory of users. 



CP Introduction 1-123 



• Ensures that the user is not logged on at another terminal (an 
error condition), or reconnects the user if he was running in 
disconnect node. 

• Obtains pertinent information on the user's virtual machine from 
the user machine block portion of the directory. 

• Stores the correct userid (replacing the LOGONxxx userid used 
until now), virtual storage size, and other vital information in 
the virtual machine* s VMBLOK. 

• Allocates and initializes segment, page, and swap tables 
(necessary for handling of the virtual machined virtual 

storage) . 

• Schedules MSS volume mounts for any required MSS volumes if the 
MSS is available and the volume is not already mounted. 

• Allocates an extended VMBLOK (ECBLOK) if the user's virtual 
machine has the ability to run in the extended control mode. 

• Allocates and initializes virtual device blocks, control unit 
blocks, and channel blocks, using information from the user 
device blocks portion of the directory. 

• Establishes links (as feasible) to all DASD devices included in 
the directory, the accessibility of any disk being determined by 
the user access mode in the directory, and whether any other 
users are presently linked to the disk, in read mode and/or 
write mode. 

• Initializes all other virtual device blocks as appropriate, such 
as reader, punch, printer, and terminal. 

• Maps all virtual devices to real devices. 

• Performs appropriate accounting. 

• Informs the user of the date and time of the most recent 
revision to the system log message (LOGMSG) , and of the presence 
of any outstanding spooled files in his virtual reader, printer, 
or punch. 

• Sends a ready message to the user with the date and time (and 
weekday), and a message to the system operator indicating that 
the user has logged on. 

If the virtual machine has a device address or a named system in the 
directory and the initialization was not suppressed via an option on the 
LOGON command line, then that device or named system is then loaded (via 
IPL) at the conclusion of the logon process. Otherwise, when the logon 
functions are complete, the user's terminal is placed in CP read mode 
ready for the entry of his first desired command. 

Under the latter condition of no automatic IPL, the user can IPL an 
alternate nucleus by using the STOP option in the IPL command. This 
option causes the nomal IPL procedure to halt execution prior to 
loading the initial PSW, and issues a DIAGNOSE code 8 that places the 
user's terminal in CP read mode. A hexadecimal character entered in 
location X'08* changes the nucleus name. A hexadecimal character 
entered in location X'09' changes the apparent storage size. The BEGIN 
command allows the IPL procedure to continue. 
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I/O Reconfigura tion 

Three commands alter the I/O configuration of a user's virtual machine 
after he has logged on. Two are user commands, while the third a system 
operator command, because it affects the status of real devices attached 
I to the system- The ATTACH and DETACH commands are contained in DHKVDA, 
| DMKYDC, DMKVDD, and DMKVDE and the DEFINE command in DHKDEF. The system 
command scanner (DMKCFM) calls both pageable modules after their format 
and privilege classes have been validated. These commands access the 
same control- block building subroutines in the module D&KVDS that 
DMKLOG, the LOGON processor, uses. 

A ttaching a Real Device ; The system operator can dedicate any real 
device to a single virtual machine by issuing the ATTACH command. The 
device attached is available only to the given virtual machine, and all 
I/O requests to it are handled by CCff translation. If the device is a 
DASD, cylinder relocation does not occur when SEEK addresses or home 
addresses are referenced. The I/O supervisor does not queue operations 
on the device, nor does it automatically restart it or do ordered seek 
queuing. Nonsharable devices such as tape drives must be attached to a 
virtual machine to be accessed by the virtual machine. A virtual 
machine can also have a dedicated card reader/punch or printer. 
However, this is usually not necessary because of the unit record 
spooling facilities of CP. Onit record input or output on a dedicated 
(attached) device is not spooled by CP. The unit attached may be given 
a virtual address different from its real address; however, the virtual 
machine may not already have a virtual device at the attached address. 
A real device cannot be attached (1) if it is currently dedicated to 
another virtual machine, (2) if it contains minidisks that are in use by 
other vitual machines, or (3) if it is a system-owned volume that is in 
use for spooling or paging. 

Defining a Virtual Device ; A system user can define a new virtual device 
with the DEFINE command that does not require the dedication of a 
corresponding real device. Devices that can be defined are consoles, 
spooled readers, punches and printers, dialable TP lines, virtual 
channel- to- channel adapters, pseud o timers, and temporary disks. With 
the DEFINE command, the user can change any existing virtual device 
address whether it corresponds to a shared or dedicated real device or 
no real device unit. 

The DEFINE command can also describe the virtual machine channel mode 
of operation, that is, either selector or block multiplexer. The 
default mode, selector channel mode, reflects a channel busy to any SIO 
operation attempted on the same channel path that has not completed the 
previous channel SIO operation. Block multiplexer mode allows the 
successful initiation of different devices on the same channel path. 
Channel 0, a byte- multiplexer channel, is unaffected by the DEFINE 
command. Also, any channel with a channel-to-channel adapter (CTCA) 
defaults to selector mode of operation regardless of the channel mode 
selected. Use of the DEFINE command with the CHANNELS operand generates 
a virtual machine reset; therefore, it should be invoked prior to the 
virtual machine IPL operation. 

Note ; The channel mode selected has no bearing on the types of channels 
that are attached to the real system. 

Temporary disks are dynamically obtained cylinders of DASD storage 
space. They are available to the user for as long as they are part of 
his virtual machine configuration, but the data on them is destroyed 
after the user detaches the area. For all other purposes, however, they 
appear to be a standard disk. 



CP Introduction 1-125 



Detaching a Virtual Device: A virtual device can be removed from a 
virtual machine configuration prior to logging off with the DETACH 
command. A user can detach any of his own devices, and the system 
operator can detach a real device from a virtual machine. If the 
operator detaches the device, the user is informed of the operator's 
action. A real device can be detached only if it is dedicated to a 
single virtual machine or is attached to the system and is not in use 
when the DETACH is issued. 

Disconnecting a Terminal or Virtual Machine 

A user may permanently or temporarily disconnect his terminal or virtual 
machine from the system by a console command, or the terminal or virtual 
machine may be forcibly disconnected by the operator. The system can 
also log off the virtual machine. In any case, the routines that handle 
the termination process are in the pageable module, DMKOSO. 

PERMANENT DISCONNECT: The user may voluntarily remove his virtual 
machine from the system via the LOGOFF command. This command terminates 
all virtual machine operation, releases all storage occupied by control 
blocks and virtual storage pages, and disconnects the teleprocessing 
line connection to the user's terminal. If the user specifies the HOLD 
option with LOGOFF, all of the above occurs, except that the 
teleprocessing line remains enabled. This option is especially useful 
for dialed connections that are reused immediately by another user. 

The virtual machine can be forced off the system by the system 
operator via the FORCE command. This has the same effect as a 
user-initiated logoff, except that the user is informed that the 
operator has logged off his machine. A virtual machine may also be 
logged off the system: 

• If the time for a read of a system password expires (28 seconds) . 

• If the user makes a connection to the system but does not logon 
within a given period. 

• If the virtual machine is running disconnected (without an active 
terminal) and the virtual machine attempts a terminal read or enters 
a disabled wait state. 



The DMKOSOLG and DMKOSOFF subroutines process the LOGOFF command. 
DMKDSP calls DMKOSOFF directly by DMKDSP to force the logoff of a 
disconnected user as previously described. 

TEMPOR ARY DISCONNECT: A user may temporarily disconnect his terminal 
from his virtual machine by using the DISCONN command, while allowing 
the virtual machine to continue to run. This command flags the virtual 
machine as being disconnected and releases the user's terminal and 
teleprocessing line. If the HOLD option was specified in the DISCONN 
command, CP allows the line to remain enabled, and another user can use 
the terminal to log on. The disconnected virtual machine continues to 
be dispatched until it either attempts to execute a terminal read to the 
disconnected console or it enters a disabled wait state. At this time, 
the dispatcher (DMKDSP) calls the routine DMKOSOFF directly to force the 
machine out of the system. While the machine is disconnected from its 
virtual console (real terminal) any terminal output is lost; in 
addition, CP may apply a disconnected penalty to the machines scheduling 
priority, to bias the system in favor of interactive users. 
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A user's virtual machine may also be disconnected by the system. If 
the disconnected user logs on to the system while the disconnected 
machine is still running, it is reconnected and can continue to interact 
with the system in the usual manner. 

The DMKUSO subroutine processes the DISCOHN command. 



CONSOLE FUNCTIONS 



DMKCFM analyzes CP commands and passes control to the appropriate 
routine to handle the command. DMKCFM can be entered by the Attention 
key (or equivalent) at the user's terminal or directly from a virtual 
machine. 

When a console interruption occurs by the Attention key at the user's 
terminal, DMKIOSIN calls DMKCNSIN to handle the unsolicited 
interruption, then DMKCNSIN calls DMKCFMBK. 

DMKCFMBK first calls DMKFREE to obtain storage for an 18-doubleword 
input buffer. Next, DMKQCNWT is called to send the CP message to the 
terminal to inform the user that he has entered console function mode. 
DMKQCNRD is then called to read the command line entered at the console. 

DMKCFMEN is the entry point for commands coming directly from the 
virtual machine. DMKPRGIN enters at DMKCFMEN here when a DIAGNOSE 
instruction with a code of 8 is detected. The address of an 
18-doubleword input buffer is passed in register 1; therefore, a read 
to the terminal is not needed. 

After either the read to the terminal or entry from the virtual 
machine, DMKSCNFD is called to find the command type. On return from 
DMKSCNFD, register 1 points to the start of the command and register 
contains the length of the command. DHKCFCMD is then called and the 
command is matched against a list of valid commands. The list contains a 
16-byte entry for each command. Each entry contains 8 bytes for the 
name, 2 bytes for class mask, 2 bytes for an abbreviation count, and 4 
bytes containing the routine address. If the entered command matches an 
entry in the list, it is then checked to ensure that a valid 
abbreviation for the command has been used. If this test is not 
successful, DMKSCN continues to scan the list for a valid command. 
Should the abbreviation be valid, a check is then made to determine if 
this user is of the proper class to use the command entered. If this is 
successful, DMKCFM then calls the appropriate routine to process the 
command. 

After the command has been processed, control is returned to DMKCFM. 
There are three possible returns. (1) On a normal return, the input 
buffer is scanned to see if there are any more commands. If none exist, 
DMKCFM returns to the virtual machine (if entered via DIAGNOSE) or calls 
DMKQCNRD to read the next command from the terminal. (2) On a return 
plus 4, the VMCFWAIT bit is turned off to allow the virtual machine to 
run. DMKFRET is called to return the input buffer storage. Then control 
returns to either the virtual machine, if entered via a DIAGNOSE, or to 
DMKDSPCH if entered via the Attention key. (3) On a return plus 8, the 
operation is the same as plus 4 except that the VMCFWAIT bit is left on. 
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DISPATCHING AND SCHEDDLING 

The scheduler, DMKSCH, selects dispatchable virtual ■achines from the 
virtual machine population. The auxiliary routine that assists the 
scheduler and dispatcher is the request stack Maintenance routine, 
DMKSTK. 

To make decisions on dispatching and scheduling, the control program 
places all virtual machines into various categories, and recognizes user 
machines as being in one of several states. The virtual machine 
categories either interactive or noninteractive virtual machine, are 
defined in the following way: 

• An interactive virtual machine is one vhose use of the system is 
punctuated by regular and frequent terminal I/O, and does not have 
long processor execution times. A virtual machine becomes eligible 
to enter interactive status whenever a channel program for virtual 
console I/O has completed, or whenever I/O for a dedicated or dialed 
virtual telecommunications line has completed. 

• A non- interactive virtual machine is one that has violated an 
interactive criterion, or one that has entered an idle wait state by 
entering console function mode (equivalent to stopped state) , or by 
loading a wait state PSH that is not enabled for any busy channel. 
CP schedules interactive users ahead of non-interactive users. 
Non- interactive users are subdivided into several classes. Normal 
non-interactive virtual machines are scheduled by a priority scheme 
described below. A virtual machine is allowed to execute for a 
specified time period and then it is placed in a list of those 
machines that are waiting. 

To give preference to certain classes of virtual machines, a priority 
scheduling scheme allows virtual machines to be scheduled with a 
priority class. The priority is a number assigned by the directory; 
however, the number may be altered by the system operator. 

V irtua l Machine Dispatching Lists and S tates 

To efficiently manage the large inventory of potential virtual machines 
that are logged on to the system, CP defines several states that a 
virtual machine may occupy. The scheduler can move a virtual machine 
from one state to another; however, a virtual machine may exist in only 
one state at any given instant. CP can then make scheduling and 
dispatching decisions by looking only at the subset of virtual machines 
that are in the appropriate state. To do this search, it also maintains 
lists of virtual machines in certain executable states. 

A user's virtual machine may be in one of the following states: 

State Meani ng 

1 Interactive and dispatchable (in queue 1, in dispatch list) 

2 Interactive and not dispatchable (in queuel, in dispatch list) 

3 Interactive and eligible for queuel, but no available real 

storage (waiting for queuel, in eligible list) 
<* In wait state with terminal read or write active 

5 Non-interactive and dispatchable (in queue2, in dispatch list) 

6 Non-interactive and not dispatchable (in queue2, in dispatch 

list) 

7 Non-interactive and eligible for queue2, but no available real 

storage (waiting for queue2, in eligible list) 

8 Idle - waiting for asynchronous I/O or external interruption, or 

stopped (in console function mode) 
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Entries on the dispatch list are the VMBLOKs for those virtual 
machines in states 1, 2, 5, and 6, and represent the virtual machines 
that can he run at any given time. (States 2 and 6 remain in the 
dispatch list even though they are not dispatchable.) The dispatch list 
is sorted by dispatching priority, which is the ratio of processor time 
to wait time over the length of the current virtual machine task. A 
task is defined as that execution that takes place between terminal 
reads or entry to enabled wait (that is, movement from state 4 or 8 to 
state 1) and is re- projected for a virtual machine each time it is 
dropped from a queue.. Virtual machines entering state 1 always have a 
priority of <K 

The eligible list contains virtual machines in states 3 and 7: these 
virtual machines are potentially executable, but due to the current load 
on the system they are not allowed to compete for the processor, is 
soon as a virtual machine in the dispatch list is dropped from queue, 
the highest-priority virtual machine (s) in the eligible list is added to 
the dispatch list. Conditions can arise where the virtual machine that 
is added to the dispatch list has a projected working set size that far 
exceeds the remaining system capacity. The eligible list has two 
components; a section composed of those virtual machines waiting for Q1 
(interactive) and a section composed of those virtual machines waiting 
for Q2 (non-interactive) . Each section of the list is sorted by 
scheduling priority, which is determined at the time the virtual machine 
is added to the eligible list, as follows: 

1. The virtual machine's projected working set size, calculated the 
last time it was dropped from a queue, is expressed as a percentage 
of the amount of main storage' available for paging. This 
percentage, usually between and 100, is multiplied by the paging 
bias factor (stored at DMKSCHPB) . 

2. The virtual machine's priority (the priority set by the directory 
or the class A SET PRIORITY command) is multiplied by the user bias 
factor (stored at DMKSCHOB) , and is added to the paging bias 
calculated in step 1. 

3. The sum of paging and user bias is divided by the sum of the bias 
factors to obtain a weighted average. 

4. A base priority is obtained by storing the TOD clock and using the 
leftmost word, which increases by 1 approximately once per second. 
This word is then modified by shifting it left or right based on 
the priority delay factor (stored at BHKSCHPB) . If DHKSCBPD is 
positive, it indicates a right shift, thereby increasing the delay 
interval of the base priority. A negative value indicates a left 
shift. 

5. The weighted average obtained in step 3 is then logically added to 
the adjusted base obtained in step 4. 

6. If the virtual machine is entering Q2 for the first time after 
being dropped from Q1, the interactive bias factor (stored at 
DHKSCHIB) is subtracted from the priority obtained in step 5. If 
the virtual machine is entering Q1, or if it was last dropped from 
Q2, the interactive bias is not applied. 

7. The result of steps 1 through 6 is the scheduling or eligible list 
priority, and is stored in the VHEPRIOR field of the VMBLOK. 

The VMBLOK is then sorted into the appropriate section of the 
eligible list in ascending value of VHEPRIOR. The effects of the 
various biases and the delay factor are illustrated by the following 
examples. 
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Example 1 

Assuae that two virtual Machines are to be added to the eligible 
list for Q2. The paging bias factor is 1, the user bias factor is 
1, and the priority delay factor is 0- Virtual machine A has a 
projected working set size of 80 percent of available storage and a 
user priority of 50. Virtual machine B has a projected working set 
size of 20 percent of available storage and also has a user 
priority of 50. The biases are obtained as follows: 

Paging User Weighted 

User Bia s Bias Bias 

A 80 X 1 * 50 1 1 = 130/2 = 65 

B 20 X 1 * 50 X 1 = 70/2 = 35 

If A is added to the eligible list at base time 0, its eligible 
list priority is 65. If the priority delay factor is 0, B is added 
a head of A provided that B is eligible for entry to the list within 
the next (65-35) 30 seconds. If the priority delay factor is set 
to +1, the base is incremented once every two seconds. Therefore, 
although the bias difference is still 30, the delay time is now 60 
seconds. 



Example 2 

To force A to be given a weighted bias equal to B, a priority 

differential is calculated as follows: 

80 + A 20 + B 

2 2 

A = B - 60 

Therefore, for the biases to be equal, A must have a priority of 60 
less than B. For example, if A is given a priority of 10 and B is 
given a priority of 70, the biases would compute as follows: 

Paging User Weighted 

Oser Bias Bias Bias 

A 80 X 1 * 10 X 1 = 90/2 = 45 

B 20 X 1 + 70 X 1 = 90/2 = 45 



Example 3 

The large difference in priorities could be lessened by increasing 
the user bias factor. If the user bias factor is set to 3 instead 
of 1, the calculated priority differential is as follows: 



80 + 3A 20 + 3B 
4 4 



3(B - A) =60 

A = B - 20 



Now, A requires a priority of only 20 less than B to achieve 
parity. For example: 
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Paging User Weighted 
User Bias Bias Bias 

A 80X1+30X3* 170/4 = 42 

B 20 X 1 + 50 X 3 = 170/4 = 42 

The above examples illustrate the following general points about the use 
of the bias factors, the delay factor, and the user priority value: 

1. The paging and user bias factors are a Measure of the relative 
importance of the bias value. & high user bias allows greater 
discrimination via the assigned priority; while a high paging bias 
makes storage requirement the primary scheduling parameter. 

2. The virtual machine priority value, in the directory, may be 
overridden, and is the means through which selected users obtain 
improved performance. 

3. The priority delay factor is the measure of the impact that the 
paging and user biases are to have. The greater the delay value, 
the greater is the maximum delay that can be experienced by a given 
user. 

4. The interactive bias factor is a tool that enhances command 
response to conversational commands that require disk I/O, and that 
may be partially executed in Q2. 

If the paging bias factor is nonzero, the net effect of the priority 
scheme is to discriminate against virtual machines that require large 
amounts of real storage. This discrimination results in a higher level 
of multiprogramming and increased processor utilization; however, it 
must be traded off against poorer throughput for large storage users. 
The distributed scheduler is not biased; the bias factors are as 
follows: 

Paging bias factor (DMKSCHPB) = 

User bias factor (DHKSCHOB) = 1 

Priority delay factor (DMKSCHPD) = 

Interactive bias factor (DMKSCHIB) = 

Thus, the basic VH/370 scheduler schedules virtual machines FIFO within 
user priority. 

Figure 19 is a graphic breakdown of the user states, showing the 
relationship between interactive and n on- inter active states, in-queue 
and not-in-queue states, and in- list and not-in-list states. 
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Figure 19. Oser Dispatching States 
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Figure 20 shows the possible user— state changes and the reasons for 
then; any changes not described are not possible. 



Status 
Change 



From 



To 



Reason for Status Change 



2 

4 

5 

7 

8 

1 

5,7 

1 

1 

3 

1 

4 

6 

7 

8 

5 

5 

5,7 



Pagewait, SIO-WAIT, or enabled wait for any busy channel 

Enabled wait for interactive terminal read or write 

Exceeds in- queue tiie slice 

Sane as 1 to 5 except that queue 2 is full 

Wait without active I/O, disabled WAIT or hit ATTN 

Wait condition complete 

Wait completes, but in- queue time slice exceeded 

Another user drops from queue 1 and now there is room 

Terminal I/O completes while user is waiting 

Terminal I/O completes, but queue 1 is full 

Terminal I/O completes while user is active in queue2 

User puts up terminal read or write and enters wait 

Pagewait, SIO-WAIT, or enabled wait for busy channel 

Dropped from queue2 due to in-queue time-slice end 

Wait without active I/O, disabled WAIT, or hit ATTH 

Wait condition completes 

Room is found in queue2 

Asynchronous I/O or external interruption or BEGIN 



Figure 20. User Status Changes 



of Multiprogr ammin g 



To control the number of virtual machines allowed in queue, the 
scheduler monitors the paging activity of all virtual machines and of 
the total system. A decision as to whether or not to move a potential 
virtual machine from the eligible to the dispatch list is based upon 
whether or not that its projected working set exceeds the system's 
remaining capacity. Individual virtual machines* working sets are 
calculated and projected at queue drop time according to one of the 
following formulas: 



P=(A*P)/2 

If (LP-LA) * (P-A) < 
— • or — 
P=A 

If (LP-LA) * (P-A) > 
where: 

A Actual working set at queue drop time 
LA Last actual working set 
LP Last projected working set 
P Current projected working set 
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The working set is added to the current system load, which consists of 
the sun of the working sets for all virtual machines currently in a 
queue. The sun is compared to the system maximum, which is equal to the 
number of dynamically assignable pages in the system. If the virtual 
machine's projected working set will not push the system load over the 
virtual machine maximum, it is placed in the queue and added to the 
dispatchable list. 



The actual working set. A, is the smaller of the 
determined at queue drop time by the following formula: 



two values 



A = 



/ 



i=1 



PRi / N * Steals 



— or — 



Pages referenced 



where: 

N 

PR 

Steals 



Number of page reads while in queue. 

Number of pages resident at the ith page read. 

Number of times page wait was entered because of a 
stolen page. 



The number of referenced pages is determined by scanning the virtual 
machine's page tables for software referenced bits. These bits are set 
by DMKPTRAN when the page is taken from the virtual machine by CP. Thus 
the actual working set is generally the average number of pages resident 
at each page read. However, this estimate is sensitive to the overall 
system paging activity for the following reasons: 

1. If there is no paging load on the system, there is one page read 
for each resident page, and no steals; the working set therefore 
tends to be equal to about one half of the resident page total. 

2. As paging activity increases, and the working set location shifts, 
the working set tends to increase toward the average number of 
resident pages. 

3. If paging activity becomes excessive, the number of page steals 
increases to the extent that the working set expands to the maximum 
of the total number of pages referenced while in the queue. 

In summary, the scheduler selects the subset of logged-on virtual 
machines that are allowed to compete for the resources of the processor, 
with the constraint that a new virtual machine is not added to the 
active subset if its projected main storage requirement, added to those 
of the other active virtual machines, causes the current capacity of the 
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system to be exceeded. Selection within scheduling priority simply 
■eans that a executable virtual machine of high priority is always added 
to the active subset (to a queue) before a executable virtual machine of 
lower priority. If the paging bias mechanism is activated by setting 
the paging bias factor to a nonzero value, scheduler selection is in 
favor of smaller virtual machines; otherwise, selection is within 
priority. Once the active subset (the set of in-gueue virtual machines) 
has been selected, the dispatcher allocates resources of the processor 
among them. 

The list of executable virtual machines in a queue is sorted by 
dispatching (as opposed to scheduling) priority. The dispatching 
priority is a running average of a given virtual machine's processor 
time/wait-time ratio. Thus, virtual machines who are most likely to go 
into wait state, based on past performance, are dispatched ahead of 
those whose demands on the processor are more extensive. This simple 
ratio priority is normally altered if a virtual machine is identified as 
compute-bound by means of the fact that it has executed for at least 50 
ms. without entering the wait state. In this case, it is placed at the 
bottom of the dispatchable list. On the other hand, virtual machines 
identified as interactive by virtue of the frequency their requests for 
terminal I/O are placed at the top of the dispatchable list . 



I Fast Redispatch 

DMKDSP also provides a fast dispatch path for virtual machines that have 
issued specific privileged instructions that are not handled by the 
Virtual Machine Assist feature. 

These virtual machines can be dispatched very rapidly because the 
virtual machine's program old PSW needs very little reconstruction to 
redispatch the virtual machine, hence use of full PSW reconstruction 
path is not required. The decision for using the fast dispatch path 
(DMKDSPA) is accomplished by the module that handles privileged 
operation, DMKPRV or DMKVIO. A fast redispatch path is also available 
after I/O interrupts. If DMKDSP can determine that the I/O interrupt 
processing had no effect on the running virtual machine's status and it 
caused no higher- priority virtual machine to become runnable, then the 
virtual PSW stored at the I/O old PSW location will be used to 
redispatch the virtual machine. 

Enable Window 

The CP supervisor runs disabled for all I/O and external interrupts. 
The dispatcher, in order to alleviate part of this problem, will 
temporarily enable for interrupts and then disable. There are three 
occasions when the dispatcher enables for interruptions (enable 
windows) : 

1. When an enabled wait state is entered. 

2. When an enabled problem state is entered to run a virtual machine. 

3. When another part of the supervisor is entered via the unstacking 
of a CP request block. 

On occasions 1 and 2, the dispatcher ignores the enable since the system 
will soon be enabled for interruptions. On occasion 3, if the 
dispatcher finds a CP request block to unstack, it first enables then 
disables for interruptions before unstacking the request. 
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Favore d Exec ution Options 

When the resources of the processor (and real storage) are being 
allocated, the dispatching and scheduling functions are implemented in 
such a manner that options exist which allow an installation to 
designate that certain virtual machines are to receive preferential 
treatment. 

The favored execution options allow an installation to modify the 
algorithms described above and force the system to devote more of its 
resources to a given virtual machine than would ordinarily be the case. 
The options provided are: 

1. The favored execution option. 

2. The favored execution percentage. 

The favored execution option means that the virtual machine so 
designated is never to be dropped from the active (in-queue) subset by 
the scheduler. When the virtual machine is executable, it is to be 
placed in the dispatchable list at its normal priority position. 
However, any active virtual machine represents either an explicit or 
implicit commitment of main storage. An explicit storage commitment can 
be specified by either the virtual-real option or the reserved page 
option. An implicit commitment exists if neither of these options are 
specified, and the scheduler recomputes the virtual machine's projected 
work-set at what it would normally have been at queue-drop time. 
Multiple virtual machines can have the basic favored execution option 
set. However, if their combined main storage requirements exceed the 
sytem's capacity, performance can suffer due to thrashing. 

The basic favored execution option removes the primary source of 
elapsed time stretch-out in a loaded time- sharing environment. However, 
if the favored task is highly compute-bound and must compete for the 
processor with many other tasks of the same type, an installation can 
define the processor allocation to be made. . In this case, the favored 
execution percentage option can be selected for the virtual machine. 
This option specifies that the selected virtual machine, in addition to 
remaining in queue, receives a given minimum percentage of the total 
processor time, if he can use it. The percentage is assured in the 
following manner; 

1. The in-queue time slice is multiplied by the requested percentage 
and added to the virtual machine's current total processor time 
usage. 

2. When the favored virtual machine, is executable, it is always 
placed at the top of the dispatchable list until it has obtained 
his guarantee. 

3. If the virtual machine obtains its guarantee before the interval 
has elapsed, it is placed in the dispatchable list according to its 
caluculated dispatching priority. 

4. In any case, at the end of the in-queue time slice, the guarantee 
is recomputed as in step 1 and the process repeated. 

These options can impact the response time of interactive virtual 
machines and only one favored percentage virtual machine is allowed at 
any given time. 
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Dispat ch ing and Scheduling Support Routines 

Host of the routines in the CP nucleus are reenterable and multiple 
control program or virtual machine tasks can make use of one routine at 
the same time. However, there are certain areas vhere requests for a 
resource must be serialized (as in paging) or delayed while previous 
requests are serviced (as in requests to schedule I/O) . 



The CP Request Stack 

The routine handling the request obtains a CPEXBLOK from free storage 
and stores the caller *s registers in it; when the requested resource is 
free, the CPEXBLOK is stacked for the dispatcher via a call to the 
request stack manager (DMKSTK) . The dispatcher unstacks the block and 
exits to the requesting routine the next time it is entered- I/O 
requests are stacked in the same manner, except that the stacking 
vehicle is the IOBLOK, and return is passed to the address specified in 
the interrupt return address (IOBIRi) . in either case, it should be 
noted that the dispatcher always unstacks and gives control to any 
stacked IOBLOKs and CPEXBLOK s prior to dispatching a user. This 
guarantees that CP information needed by a virtual machine (such as page 
availability) is always as up to date as possible. 



CP SPOOLING 

The spooling support in CP performs three functions. 

• Simulates the operation of the virtual unit record devices that are 
attached to each user's virtual machine configuration. The 
simulation is done in such a way that it appears to the program in 
the virtual machine that it is controlling a real unit record device. 
This support involves the interception and interpretation of virtual 
machine SIOs, the movement of data to and from the virtual machine's 
virtual storage space, and the reflection of the necessary 
interruption codes and ending conditions in PSffs, CSWs, and sense 
bytes. This support is provided by the virtual spooling executive. 

• Operates the real unit record equipment, attached to the system, that 
transcribes virtual machine output spool files to the real printer or 
punch and input from the real card reader to DASD storage. This 
function is provided by the real spooling executive. 

• Provides an interface among the virtual machines, the system 
operator, and the spooling system so that the location, format, 
priority and utilization of the systems spooling data and resources 
can be controlled. 
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SPOOL DATA AND FILE FORMAT 



Data Format 



The buffers that collect and write spool data are all one page (4096 
bytes) in length, and contain the data to be transcribed and all CCWs 
necessary for operating the unit record devices that perform the 
transcription. The data is provided in the exact format required with 
no compression except that trailing blanks are suppressed. The first 
two doublewords of each buffer contain linkage information described 
below, followed by the data and CCWs, except for the first spool buffer 
which contains 3800-related information. 

Each spool logical record (card or print line) is stored as one CCW 
that moves data (READ or WRITE) , a TIC to the following CCW, and the 
full data record. Space is left at the end of each buffer so that a 
SENSE command can be inserted to force concurrent channel end and device 
end. For card punch channel programs there is an additional back chain 
field that points to the card previously punched so that error recovery 
for punch equipment checks can back up one card. The only exception to 
the format of READ/lRITE-TIC-Data is in buffers of files directed to the 
printer. In this case, immediate operation code CCWs (skips and spaces) 
are followed by the next CCW. 



File For mat 

In addition to the data and CCWs contained in each spool buffer, the 
first two doublewords contain forward and backward links to the next and 
previous buffers in the file. This two-way linkage allows the file to 
be backspaced or restarted from any point at any time. Also, it means 
that if I/O errors are encountered while reading one buffer, the file is 
put in system hold status. If purged, all buffers except those in error 
are released. The two-way chain allows this control of the file while 
preventing fragmentation by allowing pages to be assigned and released 
individually regardless of their ownership. 

The first spool buffer of an output spool file contains a special 
data record called the tag record. This record immediately follows the 
two doublewords containing the forward and backward buffer linkage 
pointers. The tag record allows VM/370 users to specify information to 
be associated with spool files that they generate. The information is 
entered via the CP TAG command, although the tag record is not 
considered a spool file data record and is not printed or punched as 
part of the spool file. However, the contents may be interrogated via 
the CP TAG QUERY command. 

The format of the tag record is a NOP CCW, followed by a TIC to the 
next CCW and a 136-byte data field. To differentiate the tag record 
from an immediate NOP CCW (no TIC-data sequence) independently of the 
command code, the "skip" bit (bit 35) in the CCW has the following 
convention: 



Bit 35 = for NOP CCW, TIC, data (tag record) 
= 1 for NOP CCW (immediate NOP command) 
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Each spool file in the systei is controlled by a spool file control 
block (SFBLOK) that is resident in storage. While the file is open, 
these blocks are chained from the devices (either real or virtual) that 
are processing the file, and from device type file anchors after the 
file is closed. There is one file chain each for printer, reader, and 
punch files. Each SFBLOK contains information about the file that 
describes its owner and originator (these can be different for 
transferred files), the filename and filetype, and the class and number 
of copies for output files. All of these attributes can be examined and 
most can be changed by the file's owner or the system operator. The 
SFBLOK also contains information such as the starting and ending buffer 
addresses for the file, the record size, certain file status flags, etc. 



SPOOL BUFFER MANAGEMENT 

Real/V irtual Storage Management 

Buffers that temporarily store spool data on its way between DASD 
secondary storage and the user's virtual machine are allocated from a 
pool of virtual storage space that belongs to CP. The size of this pool 
varies with the real storage available to VM/370 (the storage specified 
at system generation or actual real storage, whichever is less). 
Allocation is as follows: 

Virtual Buffers 
St orag e Si ze Av ailable Allocated 

38UK to 655,360 bytes 128 

655,361 bytes to 1.1 megabytes 320 

1.1 megabytes to 3 megabytes 640 

over 3 megabytes 1280 

Virtual storage buffers are allocated in 1-page increments by DMKPGT 
at the time the spool file is opened for either input or output. If no 
virtual storage space is available, the virtual machine is terminated 
with a PGT008 abend. This places limits on the number of concurrent 
spooling operations permitted by the system because spooling operates as 
a high-priority task. 

Real storage is not allocated for a spooling buffer until a virtual 
machine actually issues a SIO that attempts to transfer data between the 
buffer and the user's virtual storage space. At this time, a page of 
real storage is allocated to the buffer via the real storage paging 
manager. The buffer is locked in main storage (that is, is unavailable 
to be paged out) only for the amount of time necessary to transfer the 
data. After the data transfer is complete, the buffer is treated as a 
normal page of virtual storage, and can be selected to be paged out. 
This ensures that low- usage spool files do not have buffers in real 
storage, while the buffers for high-usage files should remain resident. 
(Two spool file buffers are maintained for a 3800 printer.) The 
location of the spool buffer in real storage is transparent to the 
virtual spooling executive, because all references to the data therein 
are accomplished through the DAT feature of the processor. 
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DASD Sjgace Allocation 

While a spool buffer is inactive, it resides in real storage or on the 
paging device. After it has been filled with data from the virtual 
■achine or a real input reader, it is written to a page of secondary 
DASD storage. The allocation of pages on the spooling disk (s) is 
managed by DHKPGT, which handles requests for both pages of virtual 
storage and semipermanent spool file residence. DHKPGT maintains 
separate allocation block chains for virtual storage and spooling pages. 
Each block contains control information and a bit map that allocates 
pages on a single cylinder. If none of the cylinders allocated have any 
available pages, DHKPGT enters its cylinder allocation routine. 

DHKPGT attempts to even out the spooling and paging I/O load by 
allocating cylinders across channels and devices. To minimize seek 
times on a given device, cylinders are allocated as close to the 
relative center of the spooling or paging area as possible. 

Pa ging Device Support: All actual I/O for the page buffers on any device 
is controlled by the paging I/O executive DHKPAGIO. 



VIRTUAL SPOOLING HANAGER (DHKVSP) 

The two functions of the virtual spooling manager are (1) to simulate 
the operation of all spooled unit- record devices attached to the user's 
virtual machine, and (2) to read and write the spool files associated 
with those devices. The following virtual devices are supported for 
spooling, with the exceptions noted: 

• IBH 2540 Card Reader/Punch, except for punch feed read and column 
binary 

• IBH 3203 Printer Hodel 4 and Hodel 5 (132 positions) 

• IBH 1403 Printer Hodels 2 and N1 (132 positions) 

• IBH 3211 Printer (150 print positions) 

• IBH 3505 Card Reader (except for mark senses reading) 

• IBH 3525 Punch (except for the card read, print, and data protect 
features) . 

The following consoles are supported for spooling when entered into 
the directory as the virtual system console: 

• IBH 1052 Printer-Keyboard, Hodel 7 (via the 2150 Console) 

• IBH 3210 Console Printer-Keyboard, Hodels 1 and 2 

• IBH 3215 Console Printer-Keyboard, Hodel 1 

All virtual printers must have the universal character set feature. 
Ho checking is done on the spooled printer data. However, any DCS 
buffer commands issued by the virtual machine (load DCS buffer, block 
data checks, etc.) are ignored. It is up to the user and the 
installation to ensure that the output is directed to the proper real 
printer via use of the output CLASS feature described below. For the 
3211 or 3203 printer, forms control buffer (FCB) commands are accepted 
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and simulated by means of a virtual FCB maintained by the executive. 
The use of the virtual FCB is the only way to simulate end-of-form 
conditions reflected by the detection of a channel 9 or 12 punch. When 
the spooled file is directed to a real 3211, 3203, or 1403, the operator 
is responsible for loading the FCB or mounting the proper carriage tape. 

If any of the unsupported unit record features are required, the real 
device must be attached directly to the user*s virtual machine. Thus, a 
3505 reader could be a spooling input reader, but attached directly to a 
batch virtual machine when it is necessary to read mark sense cards. 



Output File Processing 

DMKVSP receives control from the virtual I/O executive, DMKVIO, when the 
user's machine issues a SIO to a spooled unit record device. DMKVIO 
does not pass control until it has been determined that the device is 
available (that is, it is not busy and has no interruptions pending). 
DMKVSP first determines if the device is currently processing a file. 
If it is, processing continues. If this is the first command issued by 
the given device, a new output file must be opened. An open subroutine 
is called to build the control blocks necessary to manage the file and 
to obtain virtual storage and DASD buffer space. Control is then 
returned to DMKVSP. 

Before the first record of an output spool file is written, DMKVSP 
writes a tag record (NOP CCW, TIC, data sequence) and initializes the 
136-byte data area to blanks. It then sets the spool buffer displacement 
pointer to the first doubleword in the buffer beyond the tag record. 
DHSVSP then analyzes and interprets the channel program associated with 
the virtual machine's SIO. Each CCW is tested for validity of command, 
address, flags, alignment, protection, etc., and if the CCW is valid, 
the virtual machine's data is moved from his own virtual storage space 
to the buffer in the spooling virtual storage. When this buffer is 
full, it is written to a page of DASD secondary storage and a new buffer 
is obtained. The interpretation of the virtual machine's channel 
program continues until there are no more CCWs or until an error 
condition is detected that prohibits further processing. In either 
case, the device is marked as having the proper interruptions pending, a 
CSW is constructed, and DMKVSP exits to the main dispatcher. In contrast 
to nonspooled I/O, the virtual machine has remained in a pseudo-wait 
(IOW AIT) for the time it took to interpret the entire channel program. 

The output file can be logically closed by the virtual machine either 
by issuing an invalid CCW command code, or by the CP CLOSE command. In 
either case, DMKSPL checks for tag record information 
I and 3800-related information in the VSPXBLOK. (The VSPXBLOK, pointed to 
by the VDEVEXTH field of the VDEVBLOK for the output spool device, 
contains the tag information entered via the CP TAG command.) If tag 
data exists, the first spool buffer for the file is read in, the tag 
data is inserted in the tag record, and the buffer is rewritten to DASD 
storage. If no tag data exists, the tag record data field is left blank. 
The device is then cleared of pending interruptions, the file chains are 
completed, and the file is either queued for output on a real device of 
the proper type (printer or punch) , or, if XFER is in effect, is queued 
for input to another virtual machine. 

I The 3800-related information includes: 

I CHARS - character arrangement table 
I MODIFY - copy modification name 
l FCB - file control block 
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I FLASH - flash count overlay use 

| This information is contained in the VSPXBLOK for a virtual printer. 
I When the file is closed, the information is contained in the first DASD 
| buffer. 

Input File Proc essin g 

Input file processing is similar to output file processing, except for 
the open and close functions, and the analysis of CCW commands and the 
direction of data movement. Hany common routines are utilized to locate 
and verify CCWs, obtain buffer space, and to move the spooling data. 

The difference in the open function is that instead of creating a new 
file, it is necessary to locate a reader file that already exists in the 
system. To do this, the open subroutine scans the SFBLOKs chained from 
the anchor, READERS, to find a file with an owner userid that matches 
that of the caller and is not in hold status. If a file is not found, a 
unit check or intervention reguired condition is reflected to the 
virtual machine; otherwise, its SFBLOK is chained to the control block 
for the reader and the channel program is interpreted in the same manner 
as for an output file. 

After the input file is exhausted, a unit exception is reflected to 
the user machine, unless the user has requested either continuous 
spooling or that an EOF not be reflected. With continuous spooling, the 
unit exception is not reflected until the last file for that virtual 
machine is processed. If NOEOF is specified, the simulation terminates 
with a unit check or intervention- reguired condition (similar to what 
happens if the EOF button on a real reader is not pushed) . 

In either case, the input file is then deleted from the system, 
unless the user has specifically requested that his input files be 
saved. If the file is saved, it can be re-read any number of times. 

Virtual Console Spooling 

Support of virtual console I/O for both the virtual machine and VM/37 
is provided as an option for the VM/370 spooling capabilities. This 
support fulfills the following requirements: 

• Provides hardcopy support for CMS Batch Facility virtual machines. 

• Provides hardcopy support for display devices used as system or 
virtual machine consoles. 

• Allows disconnected virtual machines to spool virtual console output, 
CP commands and system resources to disk instead of losing the 
output. 

• Improves the performance of virtual machines that currently produce a 
large amount of console output. 

Whenever a SIO is issued to a virtual machine console, the virtual 
console manager (DMKVCN) determines if the spooling option is active. 
If it is, control is passed to the virtual spooling manager at DMKVSPBP 
to insert the data into a spool file buffer. While console spooling 
utilizes, basically, the same code as printer spooling, the following 
exceptions are made: 
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• A skip to channel 1 CCW is inserted after every 60 lines of output. 

• The operator 1 s virtual console spool buffer is written out after 
every 16 lines of output. 

• The virtual spool buffer is written out to the allocated spool device 
when the first CCW is placed in that virtual buffer. The linkage area 
of the virtual spool buffer takes the fori of a CLOSE file to allow 
checkpoint (DMKCKP) to recover the active spool file in the event of 
a shutdown because of system failure. If data in the virtual buffer 
has not yet been written to the spool device, it will not be 
recovered. 

To maintain a pseudo closed file status for console spool files, 
DMKSPL now assigns spool identifications to all output spool files 
where they are first queued. 

A virtual system reset, device reset, or IPL does not close the 
virtual console spool file. The LOGOFF, FORCE, or DETACH of virtual 
console commands does close the virtual console spool file. The 
SHUTDOWN command does close the operator's console spool file. If 
the SHUTDOWN command is issued by a Class A user other than the 
operator, the console spool file for both the user and operator is 
closed. 

The inclusion of the spool file tag record in a virtual console spool 
file is processed by DMKVSP and DMKSPL as described for printer spool 
files in "Output File Processing" under "Virtual Spooling Manager." 



REAL SPOOLING MANAGER (DMKRSP) 

The real spooling manager operates the real unit record devices that are 
attached to the system and that are used to transcribe input data into 
reader spool files and user output spool files onto the real printers 
and punches. The executive optimizes the use of main storage and the 
processor rather than running the system unit record devices at their 
rated speeds. DASD input files are not double-buffered 

except for a 3800 printer, and under periods of peak load, input and 
output devices tend to run in bursts. However, command chaining is used 
for all unit record channel programs so that the devices are running at 
their maximum speed with a minimum of interruptions. 



Output File Processing 

Both the input and output operations of DMKRSP are interruption driven. 
Thus, DMKRSP does not process unless an internally or externally 
generated not-ready to ready device end interruption occurs. External 
interruptions are generated by the hardware in the normal manner, while 
internal, "pseudo interruptions," are generated by the software when an 
output file has been queued on the real printer or punch file chain, or 
when the operator issues a START command to a drained device. 

Upon receipt of the initial device end for a printer or punch, DMKRSP 
searches the appropriate file chain for the SFBLOK of a file whose class 
matches that of the device that was made ready. If FLASH is specified 
for a 3800 printer, the flash overlay name must also match. When the 
SFBLOK is located (provided the file is not in a hold status) , it is 
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unchained from the output queue and chained to the real device block 
| that services the file. A page of real main storage (two pages for a 
3800 printer) is then obtained for use as a buffer, and the output 
separator routine (DMKSEP) is called to print output identifier pages, 
j DMKTCS is then called to set up the 3800 for printing that file. When 
DMKSEP returns control to DMKRSP, the first buffer of the file is paged 
into real main storage, and the CCWs in the channel program that it 
contains are adjusted so that their data addresses correspond to the 
real addresses at which the data resides. The real SIO supervisor 
(DMKIOSQR) is then called to start the channel program, and DHKRSP exits 
to the dispatcher (DMKDSPCH) to avait the interruption. 

When the channel end/device end interruption for the completed buffer 

is unstacked to DMKRSP, the forward chain file link field locates the 

next buffer. This buffer is paged-in, and the process is repeated until 

the final buffer is processed. At this point, the number of copies 

requested for the file is decremented. If the number of copies is 0, 

processing is terminated and the file is deleted from the system; 

| otherwise, the process is repeated as many times as necessary. For a 

j 3800 printer, double buffering is maintained so that the second buffer 

I is filled while the first buffer is being printed. 

When file processing is complete, a scan of the appropriate output 
queue is again made, and if a file is found it is processed. If the 
queue is empty, or if a file with a matching class is not found, an exit 
| is taken to DMKDSPCH to wait for another ready interruption. If a 3800 
j device is used, the file is placed on the 3800 delayes purge queue. If 
j this queue reaches maximum size, the oldest file in the queue is deleted 
| from the system. 

Output file processing can be modified by either the system operator, 
by a spooling support command or as a result of system errors. The 

operator commands allow a given file to be backspaced or restarted, and 

the files of individual users or the whole system to be held and 

released for output. I/O errors also affect the spooling system, and a 

description of how they are processed is in the section "Spool File 
Error Recovery." 

Input File Processing 

Reader file processing is initiated by the receipt of a device end 
interruption from a spooling card reader. Ho explicit operator command 
is required to start the processing of an input file. When the device 
end is unstacked to DMKRSP, an open subroutine is called to build the 
necessary control blocks and to obtain the virtual, real, and DASD 
buffer space required for the file. A channel program to read 41 cards 
is built in the buffer, and DMKIOSQR is called to start the reader. 

When the interruption for the first buffer is unstacked, the first 
card is checked for its validity as a userid card. The minimum 
information that this card must contain is the userid of the owner of 
the input file. It may appear anywhere on the card, with the 
restriction that it must be the first information punched. Optional 
information on the userid card can include a filename and type and/or 
the class of the virtual card reader to which the file is to be 
directed. If the userid is valid, the file processing continues; 
otherwise, the operator receives an error message and processing is 
terminated. 

After each file buffer is read, it is written onto disk by the paging 
I/O routines in the same way that virtual output files are handled. 
When a unit exception signaling physical end of file is received from 
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the reader, the file is closed by writing the final buffer to disk and 
completing and queuing the SFBLOK to the reader *s file chain. If the 
owner of the file is currently logged on, he is given a Message 
indicating that a file has been read and if he has an available card 
reader, it is posted with a device end interruption. An available 
reader is one of the correct class which is ready, is not busy, has no 
active file, and has no pending interruptions. 

Accounting Card P rocessin g 

Various routines in CP accumulate, format, and punch account cards that 
contain system usage information for certain users. These routines 
format the information into an 80-column card image preceded by a punch 
CCW and call DMKACOAQ to queue the card for real output. DMKACOAQ calls 
DMKACOPO to punch the card on a real punch, if one is available; 
otherwise, the card is queued in main storage until a punch is free. 
When a punch finishes processing its last file, a test is made to see if 
any accounting cards have been queued. If they have, DBKACOPD is called 
to process them. 

In addition to the cards generated by CP to account for a virtual 
machine's use of system resources, the user may request cards to be 
punched in order to account for the use of virtual machine resources by 
jobs running under his userid. In order to do so, the user must have 
the account option (ACCT) entered into the directory. 

To punch an accounting card, the user must issue a code X'OOUC 1 
DIAGNOSE instruction with a pointer to either a parameter list 
containing user- specif ied "charge to" information, or a data area 
containing up to 70 bytes of user-specified information to be punched 
into the accounting card. DMKHVC validates the instruction operands, 
builds an account buffer (ACNTBLOK) , and DHKACOQ0 is called to queue the 
card for real output. For additional information about this user 
option, see "DIAGNOSE Interface (DMKHVC)" under "Privileged 
Instructions." 

When the user accounting option is being utilized, the user must keep 
in mind that each additional accounting record requested is occupying 
real storage space. Degradation of system performance occurs if 
available storage becomes filled with accounting data. 



SPOOLING COMMANDS 

The spooling commands provide an interface between the user, the system 
operator, and the spooling system. There are three types of spooling 
commands: 

• Those that affect virtual devices 

• Those that affect real devices 

• Those that affect spool files that are queued within the system 

The commands that affect virtual devices are generally available to 
all system users, and a user can only affect the status of devices that 
are attached to his own virtual machine. Commands that affect the 
status of the real system's spooling devices can be used by the system 
operator only. Commands that affect closed spool files that are 
awaiting processing are generally available to all users, with some 
additional capabilities assigned to the system operator. For example, a 
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user may alter the characteristics only of those files that have an 
owner's userid that matches his own, whereas the system operator may 
change any spool file in the system. 

File States and Attri bute s 

Each spool file in the system has a number of attributes that are 
assigned to it, either explicitly or by default, at the time that it is 
created. These attributes and their values are as follows: 

• Filename and filetype can be 24-character fields. Either or both 
can be replaced by a user- supplied value. 

• Spoolid number is a system-assigned number between 1 and 9900. It 
is automatically assigned when the file is created (input) or closed 
(output), and is unique within the system. The file's owner, the 
device type, and the id number are specified. Usually, the userid 
defaults to the identification of the user issuing the given 
command. Because the identification number rather than the filename 
and filetype is an identifier, duplicate user-assigned names do not 
present an identification problem. 

• The number of logical records (cards or print lines) in the file is 
an integer between 1 and 16 million,, For printer files, the record 
count also includes any immediate operation code space or skip CCWs. 

• The originating user is the identification of the file's creator, if 
the file has been internally transferred from the originator's 
printer or punch to the new owner's card reader. 

• The number of copies requested for an output file is between 1 and 
99. Unless altered by the user or operator, it defaults to 1. 

• The device type is used by DIAGNOSE for a file transferred to a 
reader to determine the virtual type of output device. 

| • CHARS for 3800 printer 

I • FCB for 3800 printer 

I • MODIFY for 3800 printer 

| • FLASH for 3800 printer 

In addition to those attributes, a file that is queued for real 
output or virtual input always has a class associated with it. A class 
is a single alphameric character from A through Z or from to 9. It 
controls both the real or virtual device on which the file will be 
printed, punched, or read, and the relative priority and sequence of 
output on the device. While each file is assigned a single class, each 
real spooling output device can be assigned from one to four classes. 
The device then processes only files that have a class attribute that 
corresponds to one of its own, and processes these files in the order 
that its own classes are specified. 

For example, if a printer is assigned the classes A, D, 2, it 
processes any printer file with a class of A before it searches the 
printer output queue for a file with class D. All class D files are 
printed before class 2 files. 

The output class for a file is assigned at the time the file is 
created and is the class that is associated with the virtual device that 
created it. While each real spooling device can have up to four 
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classes, each virtual spooling device can have only one. When a user 
logs onto to the system, the class associated with a device is the one 
defined in his directory entry for that device. However, he can alter 
this class at any tiae by the SPOOL command. As files are created and 
closed by a device, they take on the device's output class. 

After they are closed and are awaiting output, their class can be 
changed by a CHANGE command issued either by the file's owner or the 
system operator. The system operator can alter the system generated 
output class (es) of a real output device by the START command. 

Output files transferred to a user's virtual reader can also be 
controlled by class. If the receiving user has several readers, the 
input to each can be limited to files of a certain class. In addition, 
the ORDER command allows sequencing of input files by class as well as 
spoolid number. 

Output priorities can also be managed by altering the hold status of 
a file. Individual users can alter the hold status with the CHARGE 
command, while the system operator can change (hold or free) the files 
of specific individual users. 

SPOOL and CHANGE commands can be used to modify the CHARS, FCB, MODIFY, 
and PLASH attributes of a file or a virtual printer. 

V irtua l Device Spooling Commands 

These commands affect the status of a user's virtual spooling devices: 

Command Meaning 

CLOSE Terminates spooling operations on a specified device. It 
clears the device of any pending interrupt conditions, and for 
output files, updates the tag record, completes and queues the 
file for real output. Optional operands allow the user to 
specify a filename and filetype, and to override for the given 
file any standard CLASS, HOLD/NOHOLD or COPY operands set into 
the output device by the SPOOL command. 

SPOOL Establishes the file attributes that apply to files created 
on, or read by, the given device. It establishes the class 
that will be in effect, whether: files are to be automatically 
held, input files are to be saved or purged after reading, and 
output files are to be directed to the real system printers 
and punches or are to be transferred to a user's virtual 
reader. The SPOOL command also specifies 3800 attributes. 



R eal D evice Sp oolin g Comman ds 



The operator can use these commands to control the activity of the real 
spooling devices: 

Co mmand Meaning 

BACKSPAC Backspaces an active spooling device for either a specified 

number of pages (printers only) or to the beginning of the 

file (printers or punches) . 

DRAIN Stops the operation of a specified output or input device 
after it has finished processing the file on which it is 
currently working. A printer must be drained prior to the 
issuance of the LOADBUF command. Onit record devices are 
normally drained prior to system shutdown. 
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START Restart a device after it has been drained. Options allow the 
operator to specify the spooling output class for the output 
device and output separator records. For a 3800 printer, the 
IMAGE CHAR, FCB and PURGE options may also be specified. 

FLUSH Immediately halts the output on the specified device and 
either flushes that copy of the file from the system, or puts 
it into the system hold status for future processing. 

REPEAT Supplements the number of copies requested by the user for the 
file when it was created. The operator can specify a number 
from 1 to 99 that is added to the number specified by the 
user. 

LOADBUF Loads the universal character set buffer of the FCB of the 
specified printer with the specified image. If requested, the 
system verifies the loading by printing its contents on the 
affected printer. 

SPACE Forces the output on the specified printer to be single 
spaced, regardless of the skipping or spacing commands 
specified by the file's creator. 

S pool File Management Commands; The spooling commands alter the 
attributes and status of closed spool files that are queued and awaiting 
processing. When a command applies to an individual file, the device 
type (RDR, PUN, PRT) and the spoolid number must be provided to identify 
the file. In most coimands requiring a spoolid, the keyword CLASS 
followed by a valid spool class or the keyword ALL are acceptable 
substitutes for the spoolid number. This causes the command to be 
executed for all files of the given class or device type. The userid is 
the identification of the user issuing the command, except that the 
system operator must explicitly supply the identification of the user 
whose files he wishes to affect or he must specify the keyword SYSTEM, 
which gives access to all files (valid for CHANGE, PURGE, ORDER, and 
TRANSFER commands also) . 



Command 
CHANGE 



HOLD 



FREE 



Meaning 

Changes the filename and filetype, the number of copies, and 
the class of the specified file. The CHANGE command also 
specifies 3800 attributes. Any of the above attributes of a 
file can be determined via the QUERY command. 

Places, via the system operator, the specified file in a hold 
status. The file is not printed or punched is released by the 
system operator. The operator can hold any user files by 
device type. 

Opposite of the HOLD command. Allows a file or group of files 
that were previously held to become available for processing. 
However, the user cannot reset a hold that was set by the 
operator with the HOLD command. 



PURGE 



Removes unwanted spool 
printed or punched. 



files from the system before they are 



ORDER 



Reorders the input files in a virtual card reader. It can 
order files by identification number, by class, or by any 
combination of the two. 



TRANSFER Transfers a virtual reader to another user's virtual reader 
without any processing. The TRANSFER command causes a 
changing in the owning userid field in the file's SFBLOK. 
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SPOOL FILE ERROR RECOVERY 

Onit Record I/O E rror s 

I/O errors on real spooling unit record devices are handled by a 
transient routine that is called by DMKIOS after it has sensed the unit 
check associated with the error on a spooling device. If appropriate, a 
restart CAW is calculated and DMKIOS is reguested to retry the 
operation, in some cases waiting for a device end that signals that the 
failing device has been made ready after manual corrective measures have 
been taken. If, after retrying the operation, the error is 
unrecoverable, DMKIOS is informed that a fatal error has occurred. 
DMKIOS then unstacks the interruption, flagged as a fatal error, and 
passes control to real spooling executive. The routines that handle 
unstacked interruptions in real spooling execute only module operations 
that have been completed correctly or those that are fatal errors. If a 
fatal error is unstacked, the recovery mechanism depends on the 
operation in progress. 

For fatal reader errors, processing of the current file is terminated 
and any portion of the file that has been read and stored on disk is 
purged. The owner of the file is not informed of the presence of a 
fractional part of the file in the system. 

For fatal printer or punch errors, the SFBLOK for the partially 
completed file is re-gueued to the appropriate output list and 
processing can be resumed by another available printer or punch, or can 
be deferred until the failing device is repaired. 

In any case, the failing device is marked logically offline, and no 
attempt is made by the system to use it until the operator varies it 
back online via the VARY command. 



I If an invalid load module is specified for a 3800 printer (refer to 

I DIAGNOSE code X'7H') , the file involved is held or purged, and the 

I printer gueue is searched for the next file to print. In addition, the 

I user and operator are sent a message (DHKRSE241E) , describing the 

I action. 



D£SD Errors Du rin g Spoo ling 

DASD I/O errors for page writes are transparent to the user. A new page 
for the buffer is assigned, the file linkage pointers are adjusted, and 
the buffer is rewritten. The failing page is not de-allocated and no 
subseguent reguest for page space is granted access to the failing page. 
If an unrecoverable error is encountered while reading a page, 
processing depends on the routine that is reading the file. If the 
processing is being done for a virtual reader, the user is informed of 
the error and a unit check/intervention required condition is reflected 
to the reader. If the processing is being done for a real printer or 
punch, the failing buffer is put into the system hold status, and 
processing continues with the next file. In either case, the DASD page 
is not de-allocated and it is not available for the use of other tasks. 
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DASD S pool Space Exhauste d 

If the space allocated for paging and spooling on the system's DASD 
volumes is exhausted and more is requested by a virtual spooling 
function, the user receives a Message and a unit check intervention 
required condition is reflected to the virtual output device that is 
requesting the space, the output file is automatically closed and it is 
available for future processing. The user can clear the unit check and 
periodically retry the operation which will start when space is free or 
completely restart later from the beginning of the job. If the task 
requesting the space is the real spooling reader task, the operator 
receives an error message and the partially complete file is purged. 
Any time the spooling space is exhausted, the operator is warned by a 
console message and alarm. However, the system attempts to continue 
normal operation. 



RECOVERY FROM SYSTEM FAILURE 

Should the system suffer an abnormal termination, CP attempts to perform 
a warm start. Spool file and device data, as well as other system 
information is copied from real storage to warm start cylinders on DASD 
storage. Ihen the system is reinitialized, the spool data and other 
system data is retrieved from the warm start cylinders and operation 
continues. 

If the warm start data in real storage was damaged by the abnormal 
termination, the warm start procedure recognizes the situation and 
notifies the operator that a warm start cannot be performed. Another 
recovery method would be to attempt a checkpoint start. 

The spool file recovery routines (DMKCKS) dynamically checkpoint on 
DASD storage; the status of all open reader files, the status of all 
closed output files, real spooling device data, and system hold queue 
information. This information is stored on checkpoint cylinders that 
are allocated, along with warm start cylinders, at system generation. 

When a checkpoint (CKPT) start is requested, spool file and spooling 
device information is retrieved from the checkpoint cylinders. Spool 
file blocks are chained to their appropriate reader, printer or punch 
chains; record allocation blocks are reconstructed; spooling device 
status is restored; and, system hold queues are chained to the proper 
devices. System operation then continues. 

If the checkpoint start procedure encounters I/O errors or invalid 
DASD data on the checkpoint cylinders, the operator is notified. The 
FORCE option of the checkpoint start performs all the checkpoint start 
functions except that, invalid or unreadable files are bypassed. While 
this is at best a partial recovery, the only other alternative is a cold 
(COLD) start, where all spool file data is lost. 



RECOVERY MANAGEMENT SUPPORT (RMS) 

The machine check handler (MCH) minimizes lost computing time caused by 
machine malfunction. MCH does this by attempting to correct the 
malfunction immediately, and by producing machine check records and 
messages to assist the service representatives in determining the cause 
of the problem. 
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The channel check handler (CCH) aids the I/O supervisor (DMKIOS) to 
recover from channel errors. CCH provides the device-dependent error 
recovery prograis (ERPs) with the information needed to retry a channel 
operation that has failed. 

This support is standard and model-independent on the external level 
(from the use^s point of view there are no considerations, at system 
generation time, for model dependencies) . 



SYSTEM INITIALIZATION FOR RMS 

DMKCPI calls DMKIOEFL to initialize the error recording at cold start 
and warm start. DMKIOEFL gives control to DHKIOG to initialize the MCH 
area. A store CPU ID (STIDP) instruction is performed to determine if 
VM/370 is running in a virtual machine environment, or running 
standalone on the real machine. If VM/370 is running in a virtual 
machine, the version code is set to X'FF' by DMKPRV. If the version 
code returned is X'FF*, the RMS functions are not initialized beyond 
setting the wait bit on in the machine check new PSN (virtual) . This 
occurs because machine check interruptions are not reflected to any 
virtual machine. VM/370, running on the real machine, determines 
whether the virtual machine should be terminated. 

If the version code is not X'FF 1 , DMKIOG determines what channels are 
online by performing a Store Channel ID (STIDC) instruction and saves 
the channel type for each channel that is online. The maximum machine 
check extended logout length (MCEL) indicated by the Store CPU ID 
(STIDP) instruction is added to the length of the MCH record header, 
fixed logout length and damage assessment data field. DMKIOG then calls 
DMKFRE to obtain the necessary storage to be allocated for the MCH 
record area (MCRECORD) , the CP execution block (CPEXBLOK) , MCHAREA, and 
MCEL. The address of MCHAREA is put in the PSA (AMCHAREA) . Pointers to 
MCRECORD and the CPEXBLOK and put in MCHAREA. DMKIOG puts the address of 
MCEL in control register 15. DMKIOG obtains the storage for the I/O 
extended logout area and initializes the logout area and the ECSW to 
ones. The I/O extended logout pointer is saved at location 172 and 
control register 15 is initialized with the address of the extended 
logout area. The length of the CCH record and the online channel types 
are saved in DMKCCH. It should be noted that the ability of a CPU to 
produce an extended logout or I/O extended logout and the length of the 
logouts are both model- and channel-dependent. If VM/370 is being 
initialized on a Model 165 II or 168, the 2860, 2870, and 2880 
standalone channel modules are loaded and locked by the paging 
supervisor and the pointers are saved in DMKCCH. If VM/370 is being 
initialized on any other model, the integrated channel support is 
assumed; this support is part of the channel control subroutine of 
DMKCCH. Before returning to DMKIOE, the VM/370 error recording 
cylinders are initialized. DMKIOE passes control back to DMKCPI and 
control register 14 is initialized with the proper mask to record 
machine checks. 



OVERVIEW OF MACHINE CHECK HANDLER 

A machine malfunction can originate from the processor, real storage or 
control storage. When any of these fails to work properly, the processor 
attempts to correct the malfunction. 

When the malfunction is corrected, the machine check handler (MCH) is 
notified by a machine check interruption and the processor logs out 
fields of information in real storage, detailing the cause and nature of 
the error. The model- independent data is stored in the fixed logout area 
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and the model- dependent data is stored in the extended logout area. The 
machine check handler uses these fields to analyze the error, format an 
error record, and write the record out on the error recording cylinder 
of SYSRES. 

If the machine fails to recover from the malfunction through its own 
recovery facilities, the machine check handier is notified by a machine 
check interruption- An interruption code, noting that the recovery 
attempt was unsuccessful, is inserted in the fixed logout area. The 
machine check handler then analyzes the data and attempts to keep the 
system as fully operational as possible. 

Recovery from machine malfunctions can be divided into the following 
categories: functional recovery, system recovery, operator -initiated 
restart, and system repair. These levels of error recovery are discussed 
in their order of acceptability, functional recovery being most 
acceptable and system repair being least acceptable: 

FUNCTIONAL RECOV ERY : Functional recovery is recovery from a machine 
check without adverse effect on the system or the interrupted user. 
This type of recovery can be made by processor retry, the ECC facility, 
or the machine check handler. Processor retry and ECC error correcting 
facilities are discussed separately in this section because they are 
significant in the total error recovery scheme. Functional recovery by 
MCH is made by correcting storage protect feature (SPF) keys and 
intermittent errors in real storage. 

SYST EM RECOVE RY: System recovery is attempted when functional recovery 
is impossible. System recovery is the continuation of system operations 
at the expense of the interrupted user, whose virtual machine operation 
is terminated. System recovery can only take place if the user in 
question is not critical to continued system operation. An error in a 
system routine that is considered to be critical to system operation 
precludes functional recovery and would require logout and a system dump 
followed by reloading the system. 

OPERATOR- IN ITIATED RESTART: When the errors may have caused a loss of 
supervisor or system integrity, the system is put into a disabled wait 
state. The operator is instructed to run the standalone error recovery 
(SEREP) program and then manually restart the system. 

SYSTE M REPAIR: System repair is recovery that requires the services of 
maintenance personnel and takes place at the discretion of the operator. 
Usually, the operator has tried to recover by system- supported restart 
one or more times with no success. 

SYSTEM/370 RECOVERY FEATURES 

The operation of the Machine Check Handler depends on certain automatic 
recovery actions taken by the hardware and on logout information given 
to it by the hardware. 



Processor Retry_ 

Processor errors are automatically retried by microprogram routines. 
These routines save source data before it is altered by the operation. 
When the error is detected, a microprogram returns the processor to the 
beginning of the operation, or to a point where the operation was 
executing correctly, and the operation is repeated. After several 
unsuccessful retries, the error is considered permanent. 
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ECC Validity Checking 



ECC checks the validity of data from real and control storage, 
automatically correcting single- bit errors. It also detects multiple-bit 
errors but does not correct them. Data enters and leaves storage through 
a storage adapter unit. This unit checks each doubleword for correct 
parity in each byte. If a single-bit error is detected, it is corrected. 
The corrected doubleword is then sent back into real or control storage 
and on to the processor. When a multiple-bit error is detected, a 
machine check interruption occurs, and the error location is placed in 
the fixed logout area. MCH gains control and attempts to recover from 
the error. 



Control Registers 



Two control registers are used by MCH for loading and storing control 
information (see Figure 21) . Control register 14 contains mask bits 
which specify whether certain conditions can cause machine check 
interruptions and mask bits which control conditions under which an 
extended logout can occur. Control register 15 contains the address of 
the extended logout area. 
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Figure 21. RHS Control Register Assignments 



Machine Check Handler Subroutines 



VM/370 Machine Check 
functions: 



Handler module (DMKHCH) consists of the following 



Initial analysis subroutine 
Hain storage analysis subroutine 
SPF analysis subroutine 
Recovery facility mode switching 
Operator communication subroutine 
Virtual user termination subroutine 
Soft recording subroutine 
Buffer error subroutine 
Termination subroutine 
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Initia l Analysis Subroutine 

The initial analysis subroutine of DMKMCH receives control by a machine 
check interruption. To minimize the possibility of losing logout 
information by recursive machine check interruptions, the machine check 
new PSH gives control to DMKMCH with the system disabled for further 
interruptions. There is always a danger that a machine malfunction may 
occur immediately after DMKMCH is entered and the system is disabled for 
interruption. Disabling all interruptions is only a temporary measure 
to give the initial analysis subroutine time to make the following 
emergency provisions: 

• It disables for soft machine check interruptions. Soft recording is 
not enabled until the error is recorded. 

• It saves the contents of the fixed and extended logout areas in the 
machine check record. 

• It alters the machine check new PSH to point to the term subroutine. 
The term subroutine handles second machine check errors. 

• It enables the machine for hard machine check interruption. 

• If a virtual user was running when the interruption occurred, the 
running status (GPRs, FPRs, PSW, M.C. old PSW, CRs, etc.) is saved in 
the user»s VMBLOK. 

• It initially examines the machine check data for the following error 
types: 

MCIC=ZERO 

PSW invalid 

System damage 

Timing facilities damage 

Channel inoperative on 3031/3032/3033 processor 

The occurrence of any of these errors is considered uncorrectable by 
DMKMCH; the primary system operator is informed, the error is 
formatted and recorded, and the system enters a wait state, code 001 
or 013, 

• If the instruction processing damage bit is on, it tests for the 
following types of malfunctions: 

— Multiple-Bit Error in Main Storage — Control is given to the main 
storage analysis subroutine. 

— SPF Key Error — Control is given to the SPF analysis subroutine. 

— Retry failed — If the processor was in supervisor state the error 
is considered uncorrectable and the VM/370 system is terminated. 
If the processor was in problem state, the virtual machine is 
reset or terminated and the system continues operation. 

• If processor retry or ECC was successful on a soft error, control is 
given to the soft recording subroutine to format the record, write it 
out on the error recording cylinder, and update the count of soft 
error occurrences. 

• If external damage was reported, control is given to the soft 
recording subroutine to format the record and write it out on the 
error recording cylinder. 
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M ain St orag e Analysis Subroutine 

The aain storage analysis subroutine is given control when the machine 
check interruption was caused by a multiple- bit storage error. An 
initial function points the machine check new PSW to an internal 
subroutine to indicate a solid machine check, in case a machine check 
interruption occurs while exercising main storage. 

Damaged storage areas associated with any portion of the CP nucleus 
itself cannot be refreshed; multiple-bit storage errors in CP cause the 
VM/370 system to be terminated. An automatic restart reinitializes 
VM/370. 

If the damage is not in the CP nucleus, main storage is exercised to 
determine if the failure is solid or intermittent. Multiple-bit ECC 
storage errors on a 3031, 3032, or 3033 processor are always treated as 
solid errors. If the failure is solid, the IK page frame is marked 
unavailable for use by the system. If the failure is intermittent, the 
page frame is marked invalid. The change bits associated with the 
damaged page frame are checked to determine if the page had been 
altered, by the virtual machine. If no alteration had occurred, VM/370 
assigns a new page frame to the virtual machine and a backup copy of the 
page is brought into storage the next time the page is referenced. If 
the page had been altered VM/370 resets or terminates the virtual 
machine, clears its virtual storage, and sends an appropriate message to 
the user. Normal system operation continues for all other users. 



S torag e Pro tect Feature (SPF) Analysis Subroutine 

The SPF analysis subroutine is given control when the machine check 
interruption was caused by an SPF error. An initial function points the 
machine check new PSW to an internal subroutine if a machine check 
interrruption occurs during testing and validation. The SPF analysis 
routine then determines if the error was associated with a failure in 
virtual machine storage or in the storage associated with the control 
program. 

An SPF error associated with VM/370 is a potentially catastrophic 
failure. Namely, VM/370 always runs with a PSW key of zero, which means 
that the SPF key in main storage is not checked for an out-of-parity 
condition. The SPF analysis subroutine exercises all 16 keys in the 
failing storage 2K page frame. If an SPF machine check occurs in 
exercising the 16 keys 5 times each, the error is considered solid and 
the operating system is terminated with a system shutdown. If an SPF 
machine check does not occur, the machine check is considered 
intermittent. The zero key is restored to the failing 2K page frame and 
this is transparent to the virtual machine. 

If an SPF machine check occurs, which is associated with a virtual 
machine, the SPF analysis subroutine exercises all 16 keys in the 
failing storage 2K page frame. If an SPF machine check does not occur, 
the machine check is intermittent and the SWPTABLE for the page 
associated with the failing storage address is located. The storage key 
for the failing 2K storage page frame is retrieved from the SWPTABLE and 
the change and reference bits are set on in the storage key. The 
storage key is then stored into the affected failing storage 2K page 
frame. If an SPF machine check occurs in exercising the 16 keys 5 times 
each, then the machine check is considered solid and the following 
actions are taken. (1) The virtual machine is selectively reset or 
terminated by the virtual machine termination subroutine; (2) The 4K 
page frame associated with the failing address is removed as an 
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available system resource. This is accomplished by locating the 
CORTABLE for the defective page and altering the CORFPNT and COBPBPHT 
pointers to sake the page unavailable to the system. The C0HDIS1 bit 
in this CORTABLE is set on to identify the reason for the status of this 
page in a system dump. 



Recovery Facility Mo de Switching 

The recovery facility mode switching subroutine (DMKMCHMS) allows the 

service representative to change the mode that processor retry and ECC 

recording are operating in. This subroutine receives control when a 

user with privilege class F issues some form of the SET command with the 

MODE operand. A check is initially made to determine if this is VM/370 

running under VM/370. If this is the case, the request is ignored and 

| control is returned to the calling routine. For the format and usage of 

j the SET command with the MODE operand, refer to the VM/370 Operator's 

I Guide. 



Operator Commu nicati on Subroutine 

The operator communciation subroutine is invoked when the integrity of 
the system has degraded to a point where automatic shutdown and reload 
of the system has been tried and was unsuccessful, or could not be 
attempted due to the severity of the hardware failure. A check is first 
made to determine if the system operator is logged on as a user, next a 
check is made to determine if the system operator is disconnected. If 
either of these checks is not affirmative a message cannot be issued 
directly tc the system operator. A LPSW is performed to place the 
processor in a disabled wait state with a recognizable wait state code 
in the processor instruction counter. 



virtual User Termination Subroutine 

The virtual machine termination subroutine selectively resets or 
terminates a virtual user whose operation has been interrupted by an 
uncorrectable machine check. First, the machine is marked 
nondispatchable to prevent the damaged machine from running before reset 
or termination is performed. The machine check record is formatted and 
DMKIOEMC is called to record the error. Then the user is notified by a 
call to DMKQCNWT that a machine check has occurred and that his 
operation is terminated. The primary system operator is notified of the 
virtual user termination by a message issued by a call to DMKQCHWT. If 
the virtual machine is running in the virtual =real area, DMKDSO is 
called to log the virtual machine off the system and to return the 
storage previously allocated to the virtual machine and to clear any 
outstanding virtual machine I/O requests. The HOLD option of LOGOFF is 
invoked to allow a user on a dial facility to retain the connection and 
thus permit LOGON without re-establishing the line connection. However, 
if the virtual machine is running in the virtual area, and DMKCFM is 
then called to put the virtual machine in console function mode, the 
user must re- initialize the system to commence operation. 
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Soft R ecor ding Subrout ine 

The soft recording subroutine performs two basic functions: 

• Formats a machine check record and calls DMKIOEMC to record the error 
on the error recording cylinder. 

• Maintains the threshold for processor retry and ECC errors and 
switches from recording to quiet mode when the threshold value is 
exceeded. To accomplish this, a counter is maintained by DMKMCH for 
successful processor retry and corrected ECC events. 

Processor Retry, Recor ding Mode: Recording mode (bit 4 of control 
register 14 set to one) is the initialized state, and normal operating 
state of VM/370 for processor retry errors. Recording mode may also be 
entered by use of the CP SET command. When 12 soft machine checks have 
occurred, the soft recording subroutine switches the processor from 
recording mode to quiet mode. For the purpose of model-independent 
implementation this is accomplished by setting bit 4 of control register 
14 to zero. Because in quiet mode no soft machine check interruptions 
occur, a switch from quiet mode to recording mode can be made by issuing 
the SET MODE RETRY | MAIN RECORD command. While in recording mode, 
corrected CPD RETRY | MAIN reports are formatted and recorded on the 
VM/370 error recording cylinder, but the primary systems operator is not 
informed of these occurrences. 

Proc essor Retry, Quiet Mode: Quiet mode (bit 4 of control register 14 set 
to 0) can be entered in one of two ways: (1) when 12 soft machine 
checks have occurred, or (2) when the SET MODE RETRY QUIET command is 
executed by a class F user. In this mode, both processor retry and ECC 
reporting are disabled. The processor remains in quiet mode until the 
next system IPL (warm start or cold start) occurs or a SET MODE 
RETRY | MAIN RECORD command is executed by a class F user. SET MODE MAIN 
is treated as invalid on a 3031, 3032, or 3033 processor. 

ECC Recording M odes : To achieve model-independent support, RMS does not 
set a specific mode for ECC recording. The mode in which ECC recording 
is initialized depends upon the hardware design for each specific 
processor model. For the IBM System/370 Models 135, 135-3, 138, 145, 
145-3, 148, 158, 168, 3031, 3032, and 3033, the hardware-initialized 
state (therefore the normal operational state for VM/370) is quiet mode. 
For the IBM System/370 Models 155 II and 165 II, the hardware 
initialized state (the normal operational state for VM/370) is record 
mode. An automatic restart incident due to a VM/370 failure does not 
reset the ECC recording mode in effect at the time of failure. 

The change from record to quiet mode for ECC recording can be 
initiated in either of the following ways: (1) by issuing the SET MODE 
{MAIN | RETRY} QOIET command, or (2) automatically whenever 12 soft 
machine checks have occurred. For the purpose of model-independent 
implementation, this occurs by setting bit 4 of control register 14 to 
zero. 

The change from quiet to record mode for ECC recording can be 
accomplished by use of the SET MODE MAIN RECORD command. This recording 
mode option is for use by maintenance personnel only. It should be 
noted that processor retry is placed in recording mode if it is not in 
that state when the SET MODE MAIN RECORD command is issued. 

While in recording mode, corrected ECC reports are formatted and 
recorded on the error recording cylinder, but the primary systems 
operator is not informed of these incidents. 
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Buffer Error Su brout ine 

On processor models equipped with a high-speed buffer (155 II, 158, 165 
II, 168, 3031, 3032, 3033) or a data lookaside table (DLAT) (165 II, 
168, 3031, 3032, 3033) the deletion of buffer blocks because of hardware 
failure is reported via a degradation report machine check interruption. 
MCH enables itself for degradation report machine check interruptions at 
system initialization by setting bit 5 of control register 14 to 1. If 
a machine check interruption occurs that indicates high-speed buffer or 
DLAT damage, MCH formats the record and calls DMKIOEMC to record it on 
the error recording cylinder, informs the primary systems operator of 
the failure, and returns control to the system to continue normal 
operation. 



Termination Subroutine 

The termination subroutine is given control if a hard machine check 
interruption occurs while DMKMCH is in the process of handling a machine 
check interruption. Note that soft error reporting is disabled for the 
entire time that MCH is processing an error. 

An analysis is performed of the machine check interruption code of 
the first error to determine if it was a soft error. If it was, the 
first error is recorded, the system status is restored and control is 
restored to the point where the first error occurred. If the first 
error was a hard error, the operator communication subroutine is given 
control to issue a message directly to the system operator, and to 
terminate CP operation. 

OVERVIEW OF CHANNEL CHECK HANDLER 

The channel check handler (CCH) aids the I/O supervisor in recovering 
from channel errors and informs the operator or service representative 
of the occurrence of channel errors. 

CCH receives control from the I/O supervisor when a channel data 
check, channel control check, or interface control check occurs. CCH 
produces an I/O error block (IOERBLOK) for the error recovery program 
and a record to be written on the error recording cylinder for the 
system operator or service representative. The operator or service 
representative may obtain a copy of the record by using the CMS CPEREP 
command. A message about the channel error is issued to the system 
operator each time a record is written on the error recording cylinder . 

When the I/O supervisor program detects a channel error during 
routine status examination following an SIO, TIO, HIO, or an I/O 
interruption, it passes control to the channel check handler (DMKCCH) . 
DMKCCH analyzes the channel logout information and constructs an 
IOERBLOK and, if the error is a channel control or interface control 
check, an ECSW is constructed and placed in the IOERBLOK. The IOERBLOK 
provides information for the device-dependent error recovery procedures. 
DMKCCH also constructs a record to be recorded on the error recording 
cylinder. Normally, DMKCCH returns control to the I/O supervisor after 
constructing an IOERBLOK and a record. However, if DMKCCH determines 
that system integrity has been damaged (system reset or invalid unit 
address, etc.), then CP operation is terminated. CP termination causes 
DMKCCH to issue a message directly to the system operator and place the 
processor in a disabled wait state with a recognizable wait code in the 
processor instruction counter. 
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Normally, when DMKCCH returns control to the I/O supervisor, the 
error recovery program for the device which experienced the error is 
scheduled. When the ERP receives control, it prepares to retry the 
operation if analysis of the IOERBLOK indicates that retry is possible. 
Depending on the device type and error condition, the EBP either effects 
recovery or marks the event fatal and returns control to the I/O 
supervisor. The I/O supervisor calls the recording routine DHKIOE to 
record the channel error. 

The primary system operator is notified of the failure, and DHKIOE 
returns control to the system and normal processing continues. 

If the channel check is associated with an I/O event initiated by a 
SIO in a virtual machine, the logout is reflected to the virtual machine 
in one of two ways, depending upon whether the channel check occurred at 
SIO time or later in an interrupt. If it occurred at SIO time, then 
DMK7SI (or occasionally DHKVIO) calls upon DHKCCHRF to reflect the 
logout. If it occurred in an I/O interrupt, the dispatcher notices the 
channel check as it is reflecting the I/O interrupt to the virtual 
machine, and so, at that time, DHKDSP calls upon DHKCCHRF to reflect the 
logout. 

CHAHHEL CONTROL SUBROUTINE 

Control is passed to the channel control subroutine of DHKCCH after a 
SIO with failing status stored, or an I/O interrupt because of a channel 
control check, interface control check, or channel data check. 

If "logout pending" is indicated in the CSW, the CP termination flag 
is set. The existence of real device blocks (RCHBLOK, RCUBLOK, 
RDEVBLOK), for the failing device address, is determined by a call to 
DMKSCNRU and an indicator is set if they do exist. An indicator is also 
set if the IOBLOK for the failing device address exists. A call to 
DHKFREE obtains storage space for the channel check record and the 
channel control subroutine builds the record. If the indicators show 
that the real device blocks and the IOBLOK exist, a call to DHKFREE 
obtains storage space and the channel control subroutine builds the I/O 
error block (IOERBLOK) ; if these blocks do not exist, the IOERBLOK is 
not built. The IOERBLOK is used for two purposes: 

1. The device- dependent error recording program (ERP) uses the 
IOERBLOK to attempt recovery on CP-initiated I/O events. If the 
I/O events that resulted in a channel check are associated with a 
virtual machine, the I/O fatal flag is set in the IOBLOK and the 
virtual machine is reset, cleared, and put into CP read status. 
The length and address of the channel check record is placed in the 
IOERBLOK and the IOERBLOK is chained off the IOBLOK. 

2. DHKIOECC uses the IOERBLOK to record the channel check record on 
the error recording cylinder. 

The channel control subroutine gives control to a channel-dependent 
error analysis routine to build or save the extended channel status word 
(ECSW). When the channel control subroutine regains control, eight 
active addresses are saved in the channel check record. 

If the CP termination flag is set, the I/O extended logout data from 
the channel check record is restored to main storage for use by SEREP. 
If the system operator is both logged on as a user and connected to the 
system, a message (DHKCCH603W) is sent to him advising him of the 
channel error. A LPSW is then executed to place the processor in a 
disabled wait state with a wait state code of 002 in the processor 
instruction counter. 
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If the CP termination flag is not set, a check is made to determine 
if an IOERBLOK was built by the channel control subroutine. 

If an IOERBLOK was not built, DMKIOECC is called to record the 
channel check record on the error recording cylinder. The system 
operator is then sent a message (DMKCCH601I or DHKCCH602I) informing him 
of the error and control is then returned to DMKIOS to continue system 
operation. 

If an IOERBLOK was built, control is returned to DMKIOS, which calls 
the appropriate ERP. Whether or not recovery is successful, DMKIOS 
eventually calls DMKIOE to record the channel check record. DMKIOE 
examines the status of the in CSW error in the IOERBLOK to determine if 
it was a channel error; if so, it finds the length and pointer to the 
channel check record and records the error on the error recording 
cylinder. If this was not a channel error, DMKIOE continues normal 
processing. 



INDIVIDUAL ROUTINES 

A separate channel error analysis routine is provided for each type of 
channel for which DMKCCH can be used. The purpose of these routines and 
the channel control subroutine is to analyze the channel logout to 
determine the extent of damage and to create a sequence and termination 
code to be placed in the ECSW in the IOERBLOK. At system 
initialization, the correct model dependent channel recovery routine is 
loaded and the storage necessary to support the routine is allocated. 
The model- dependent error analysis subroutines and routines and their 
functions are as follows: 



Integrated Channels (Models 135, 135-3, 138, J45, 115-3, J48, J55 II, 
158, and 3031, 3032, and 3033 Processors) 

Since all of these systems have integrated channels one common 
subroutine is used to handle all of these processor types. This 
subroutine: 

• Indicates CP termination if the ECSW is not complete, the channel has 
been reset, the reset codes are invalid, or the I/O interface is 
inoperative. 

• Moves the ECSW to the IOERBLOK 

• Moves the hardware stored unit address and the I/O extended logout to 
the channel check record 

• Sets the I/O extended logout area and ECSW area to ones 

• Returns control to the channel control subroutine 



2860 Channel (Models 165 II, J 6 8) 

The 2860 logout area is checked to determine if a complete logout 
exists; if not, CP termination is necessary. 
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A check is made in the logout area for validity of the CSW fields and 
bits are set in the channel check record*s ECSW field to indicate bad 
fields. 

The channel logout is then checked and sequence codes are set based 
on the presence of a channel control check, or an interface control 
check. If a channel control check is present, the codes set are 
determined through parity. The count determines if parity is good and 
sets a resultant condition code. 

The logout area is examined to ensure that the unit address has valid 
parity and is the same address passed by DMKIOS. If so, the 
unit-address-valid bit in the ECSW is set. If the unit address is not 
valid, the unit-address-valid bit is reset to indicate the invalid 
condition. 

The ECSW field in the channel check record is moved to the IOEBBLOK, 
if one exists. 

After completing the ECSW the 2680 routine moves the 2860 I/O 
extended logout into the channel check record, set the I/O extended 
logout area to ones, and returns to the channel control subroutine. 



2870 Channel (Models 165 II, 168) 

If the channel failed to log out completely, at least part of the logout 
area is all ones. If a fullword of ones is found, a CP termination 
condition exists. 

A check is made in the logout area for valid CSW fields, and bits are 
set in the channel check record*s ECSW field to indicate bad fields. 

The termination and sequence codes are set depending on the presence 
of an interface control check or channel control check. If a channel 
control check is present, the codes set are determined through parity, 
count, and/or data transfer checks. For the 2870, parity can be 
determined directly from the channel logout. 

The logout area is also examined to ensure valid parity in the unit 
address and to ensure that the address is the same as that passed to 
DMKCCH by DMKIOS. If so, the unit-address-valid bit in the ECSW is set. 

The third word of the logout area is also analyzed for type II 
errors. If a type II error is found, a CP termination condition exists. 

The ECSW field in the channel check record is moved to the IOERBLOK, 
if one exists. 

Before returning to the channel control subroutine, the 2870 routine 
moves the 2870 I/O extended logout into the channel check record and 
sets the I/O extended logout area to ones. 



2880 Channel (Models J65 II and J 68) 

This routine analyzes 9 words of the 28-word logout. 
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The 2880 analysis routine handles channel data checks, interface 

control checks, and channel control checks- 
Termination code 3 (system reset) is not set in the ECSW because the 

2880 channel does not issue system reset to the devices. Retry codes of 

to 5 are possible. 

Note: There are several catastrophic conditions under which the CP 
termination flag can be set, in the 2880 analysis routine. They are: 

• The channel did not complete the logout. 

• The CSW is not reliable. 

• The unit address in the I/O interruption device address field is not 
correct. 

Only a channel check record is needed if the channel has recognized 
an internal error and has recovered from it without any damage. Ho 
recovery action is necessary in these cases. 

If the channel address in the I/O interruption device address field 
does not match the channel address in the logout, a CP termination 
condition exists. 

If the channel was doing a scan and the unit control word had a 
parity check a CP termination condition exists. If there was no parity 
check, there was no damage during the scan and only a channel check 
record is required. 

Depending on the sequence the channel has entered, the termination 
and sequence codes are set; command address, unit address, and unit 
status validity is determined; and the sequence code is set valid. The 
ECSH field in the channel check record is moved into the IOERBLOK, if 
one exists. 

Before returning to the channel control subroutine, the 2880 routine 
moves the I/O extended logout into the channel check record and sets the 
I/O extended logout area to ones. 



ERROR RECORDING INTERFACE FOR VIRTUAL MACHINES 

The error recording interface provides a means of recording errors 
encountered by operating systems running in a virtual machine under 
VH/370. If the virtual operating system is VH/370, it must be the 
Release 2.0 version or later. An SVC 76 issued by a virtual machine is 
used to signal VH/370 that error recording is required. The SVC 
interruption handler in DMKPSA examines general registers and 1 to 
determine if valid parameters have been passed. If valid parameters are 
not found, the SVC is reflected back to the virtual machine and no 
recording takes place. If valid parameters are passed, a pageable 
routine (DMKVER) processes the error record. 

DMKVER validates the record passed by the virtual machine. If 
invalid conditions are found, no recording takes place. Control is 
returned to the SVC interruption routine in DMKPSA to reflect the SVC to 
the virtual machine as an SVC interruption. The action taken by the 
virtual machine is dependent on the operating system running in the 
virtual machine, not VM/370. If the record is valid, it is modified by 
changing virtual information to real. The actual recording is 
accomplished by using existing modules in DMKIOE and DMKIOF. 
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Control is then returned to the instruction following the SVC 76 
rather than reflecting the SVC. This eliminates the duplication of 
error recording in VM/370 and the operating system in the virtual 
machine. If DMKVER determines that the recording represented a 
permanent I/O error, a message is sent to the primary system operator. 



ERROR RECORDING AND RECOVERY 

The error recording facility is made up of four modules. One module 
(DMKIOE) is resident and the other three (DMKIOC, DMKIOF, and DMKIOG) 
are pageable. 

The error recording modules record temporary errors (statistical data 
recording) for CP generated I/O except for DASDs with a buffered log. 

The error recording routines record: unit checks, statistical data 
counter overflow records, selected temporary DASD errors, machine 
checks, channel checks, and hardware environmental counter sense data on 
the error recording cylinders of the system resident device in a format 
suitable for subsequent processing by the CPEREP command (DMSIFC) . The 
recorder asynchronously updates the statistical data counters for 
supported devices. The recorder also initializes the error recording 
cylinders at IPL if they are in an unrecognizable format. 

When the recorder is entered from DHKIOS, it is entered at DMKIOERR. 
This entry is used for unit checks and channel data checks. A test is 
made of the failing CSW (located in the IOERBLOK) to see if the error 
was a channel error. If it was, control is passed to the routine for 
recording channel checks. 

The IOERBLOK sense data, IOBLOK flags, and VMBLOK privilege class are 
examined to determine if the error should be recorded. 



ERROR RECORD WRITING 

After an error record is formatted, it is added to the error recording 
cylinder using DMKRPAGT and DMKRPAPT. The error recording cylinders 
have page-sized records (4096 bytes) . Each page contains a header (8 
bytes) which signifies: the cylinder and page number of the page (4 
bytes), the next available space for recording within page (2 bytes), a 
page-in-use indicator (1 byte), and a flag byte. Each record within the 
page is recorded with a 4-byte prefix. 

If an error record is too large to be added into a page, a new page 
is retrieved, updated with record, and placed back on the error 
recording cylinder with the paging routines. 

From two to nine cylinders are used for error recording; errors are 
recorded in the order in which they occur. The cylinders that are used 
for error recording are specified by the installation or system 
programmer at system generation time. If the error recording cylinders 
become 90 percent full, a message is issued to the operator using 
DMKQCNWT to warn him of the condition. If the cylinders become full, 
another message is issued to inform the operator and recording is 
stopped. 

On the 3031, 3032, and 3033 processors, frame records are read from 
the SRF device and written on the error recording cylinders during 
initialization if no records exist after a CPEREP CLEARF operation. 
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If a channel check error is to be recorded, the recorder is entered 
at DMKIOERR or DMKIOECC. The channel check handler determines the 
entry. A channel check error record is formatted. 

A machine check enters at DMKIOEMC. Pointers are passed from the 
machine check handler in registers 6 and 7 to locate a buffer where the 
machine check record and length are saved. A machine check error record 
is recorded with the saved machine check logout and additional 
information. The machine check error record is written onto the error 
recording cylinder by using the paging routines. 

Hardware environmental counter records are formed using routine 
DMKIOEEV. This routine is scheduled by DMKIOS after control is returned 
from the ERP. Sense data information is stored in the IOERBLOK by the 
ERP. The record formed is called a nonstandard record. 

C lear and Format Rec ording Area 

DMKIOEFM is called by DMSIFC (CPEREP command) via a DIAGNOSE 
instruction. DMKIOEFM is invoked to reset the specified error recording 
cylinders (if CLEAR, CLEARF, or ZERO=Y was specified) . The clear is 
performed by resetting each page- header, space-available field. 
Pointers in storage are then updated to address the first available page 
on each of the error recording cylinders. Control is then returned to 
the calling routine. For details on the CPEREP command and EREP 
execution, refer to the VM/370 OLTSEP and Error Recording Guide and 
OS/VS EREP publications. 

CLEARF on a 3031, 3032, or 3033 processor clears the cylinders, then 
causes the frame records to be read from the SRF device. 



Find Fi rst Recording Cylinder at IPL 

DMKIOEFL is called by DMKCPI to find the first available page that can 
be used for error recording. The paging routines, DMKRPAPT and 
DMKRPAGT, are used to read the error recording cylinders 1 pages 
(4096-byte records) . As each page record is read, it is examined to see 
if this record is the last recorded. If so, a pointer in storage is 
saved so recording can continue on that page record. Control is then 
returned to the caller. If any error recording cylinder is in an 
unrecognizable format, the error recording area is automatically 
reformatted by CP. 



DASD ERROR RECOVERY, ERP (DMKDAS) 

Error recovery is attempted for CP-initiated I/O operations to its 
supported devices and for user- initiated operations to CP-supported 
devices that use a DIAGNOSE interface. The primary control blocks used 
for error recovery are the RDEVBLOK, the IOBLOK and the IOERBLOK. In 
addition, auxiliary storage is sometimes used for recovery channel 
programs and sense buffers. 

The initial error is first detected by the I/O interruption handler 
which performs a SENSE operation if a unit check occurs. Unit check 
errors are then passed to an appropriate ERP. If a channel check is 
encountered, the channel check interruption handler determines whether 
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or not retry is possible and passes control to an ERP through the I/O 
interruption handler. DASD errors are processed as described below. 

Channel Error s 

• I/O interface inoperative on a 3031, 3032, or 3033 processor is 
reflected to the virtual machine if the channel is dedicated. 
Otherwise, a wait state X , 0002* occurs. 

• Channel control check is treated as seek check. It is retried 10 
times. 

• Interface control check is treated as seek check. It is retried 10 
tiies. 

• Channel data check is treated as data check. It is retried 10 tiies. 

U nit Check Errors 

Equipment check: Retry the operation 10 times for 3330, 33*0, 3350, and 
2305 devices; twice for the 2314 and 2319. 

HP. record found and missing address marks: Recalibrate and retry the 
channel program 10 times (2314/2319) . 

No record found: Execute a READ HOME ADDRESS and check home address 
against seek address. If they are the same, consider the error 
permanent. If they are not egual recalibrate and retry the channel 
program 10 times (2314/2319). For other devices, return to caller. 

Seek ch eck : Retry the operation 10 times except that 3330/3350 seek 
checks are retried by hardware. 

Intervention required: Issue a message to console and wait for solicited 
device end. This procedure is repeated once. 

Bus out check : One retry of the operation. 

Data checks : For 2314/2319 retry the operation 256 times, with a 
recalibrate being executed every 16th time. For the 2305/3340, retry 
the operation 10 times. For the 3330/3350, the operation is retried by 
hardware. 

Overr un: Retry the operation 10 times. 

Missing add ress marker: Retry the operation 10 times. 

C omman d reject: The command is not retried. 

Chaining check: Test for command reject. If not present, retry the 
operation 10 times. 

Environmental data present: Issue a BUFFER UNLOAD command and retry the 
operation. 

Track c onditio n check: On CP I/O and Diagnose I/O, when a track 
condition check is received from a device for which CP does not provide 
alternate track software recovery, the condition is treated as a 
permanent error. CP does provide alternate track support for other 
devices; this support is described in the section "Alternate Track 
Recovery, ERP (DMKTRK)." 
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The error recovery routine keeps track of the number of retries in 
the IOBRCNT field of the IOBLOK- This count determines if a retry limit 
has been exceeded for a particular error- On initial entry from DHKICS 
for an error condition, the count is zero. Each time a retry is 
attempted, the count is increased by one. 

The ERP preserves the original error CSW and sense information by 
placing a pointer to the original IOERBLOK in the RDEVBLOK. Additional 
IOERBLOKs, which are received from DMKIOS on failing restart attempts, 
are discarded. The original IOERBLOK is thus preserved for recording 
purposes. 

If after a specified number of retries, DHKDAS fails to correct the 
error, the operator may or may not be notified of the error. Control is 
returned to DMKIOS. DMKIOS is notified of the permanent error by posting 
the IOBLOK (IOBSTAT=IOBFATAL) . The error is recorded via DMKIOS by 
DMKIOERR- if DMKDAS and DMKIOE determine that the error warrants 
recording. 

If the error is corrected by a restart, the temporary or transient 
error is not recorded. Control is returned to DMKIOS with the error flag 
off. 

Before returning control to DMKIOS on either a permanent error or a 
successful recovery, the ERP frees all auxiliary storage gotten for 
recovery CCWs, buffers, and IOERBLOKs, and updates the statistical 
counters for 2314 and 2319 devices. 

The DMKIOS interface with the ERP uses the IOBSTAT and IOBFLAG fields 
of the IOBLOK to determine the action required when the ERP returns to 
DMKIOS. 

When retry is to be attempted, the ERP turns on the restart bit of 
the IOBFLAG field. The ERP bit of the IOBFLAG field is also turned on to 
indicate to DMKIOS that the ERP wants control back when the task has 
finished. This enables the ERP to receive control even if the retry was 
successful and allows the freeing of all storage gotten for CCWs and 
temporary buffers. The IOBRCAW is set to the recovery CCW string 
address. 

In handling an intervention-required situation, the ERP sends a 
message to the operator and then waits for the device end to arrive. 
This is accomplished by a return to DMKIOS with the ERP bit in the 
IOBFLAG field set on and the IOBSTRT bit in the IOBFLAG field set off. 
When the device end interruption arrives, the original channel program 
which was interrupted is then started. 

The ERP flags of the IOERBLOK are also used to indicate when special 
recovery is being attempted. For example, a READ HOME ADDRESS command 
when a no record found error occurs. 

The other two indicators are self-explanatory and are explained in 
Figure 22. 
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Figure 22. Summary of IOB Indicators 



If the error is uncorrectable or intervention is required, the ERP 
calls DMKMSW to notify operator. The specific message is identified in 
the MSGPARM field of the IOERBLOK. 



ALTERNATE TRACK RECOVERY, ERP (DMKTRK) 



The software alternate track recovery support described in the following 
paragraphs applies only to the 3340/3344 disk. For 3330 and 3350 disks 
no software support is needed since the hardware performs alternate 
track recovery. No support is needed for the 2305 drum since the CE is 
able to rewire the device to use spare tracks in place of defective 
tracks. For the 2314 and 2319 disks no true alternate track recovery is 
provided by CP. But track condition checks from any device type are 
reflected back to the virtual machine. Therefore, even though CP itself 
cannot use a 2314 or 2319 cylinder that contains a defective track, it 
it possible for a virtual machine to use such a cylinder if it provides 
its own error recovery. To facilitate this, the VH/370 version of the 
IBCDASDI program allows 2314 and 2319 minidisks to be formatted with an 
alternate track cylinder as the last cylinder of each minidisk rather 
than using the last cylinders of the real disk for this purpose. 



Overview of 3340 Alternate Track Support 



The 3340 alternate track support applies to CP I/O, to Diagnose I/O 
(thereby giving alternate track support to CMS) , and to SIO executed in 
a virtual machine. For CP I/O and Diagnose I/O, the alternate track 
recovery support essentially consists of directing (seeking) an 
interrupted channel program to an alternate track and restarting it. 
Later, in some cases, the interrupted channel program is directed back 
to the original cylinder and restarted there. For SIO in a virtual 
machine, the operating system in the virtual machine provides its own 
error recovery when CP reflects a track condition check to the virtual 
machine. 

On the 3340 disk, alternate tracks are assigned in the conventional 
alternate tracks cylinders at the high end of the real disk, not in the 
last cylinder of each minidisk. Therefore a virtual machine may need to 
seek outside of its minidisk extent. This occurs when an operating 
system in a virtual machine performs its own error recovery following a 
track condition check. So for SIO issued from a virtual machine, CP*s 



1-166 IBM VM/370 System Logic and Problem Deteraination— Volume 1 



alternate track support must permit the virtual machine to escape from 
the confines of its minidisk to get to the alternate tracks assigned to 
the defective tracks of that minidisk- Yet at the same time CP must 
still prevent the virtual machine from accessing other tracks that it 
does not own. 

Since alternate tracks are assigned only in the conventional 
alternate tracks cylinders at the high end of the real disk, CP does not 
apply minidisk cylinder relocation values to a virtual machined channel 
commands that reference alternate tracks- Similarly, CP does not 
unrelocate alternate track CCHH addresses returned by read home address, 
by read record zero, in sense information, or for error recording. 



Altern a te Track H ardwar e Operation and Implication s 

The home address record (HA) on any track contains a flag byte with two 
bits that are involved in alternate track assignments. One bit, when 
set to one, indicates that the track is defective and that the track 
should have (and ordinarily does have) an alternate track assigned. The 
count field of record zero of a track with this bit set should point to 
(have the CCHH address of) the assigned alternate track. The second bit 
in the flag byte, when set to one, indicates that the track in which it 
appears is an assigned alternate track. The count field of record zero 
of an assigned alternate track should point back to (have the CCHH 
address of) the flagged defective track that it is assigned to. 

Before using the pointer in record zero of a flagged track to get to 
the corresponding alternate, it is considered good form for an operating 
system to check the pointers both ways to see that each points to the 
other. CP performs two-way checks of the pointers for seeks to an 
alternate track initiated by Diagnose or by SIO in a virtual machine. 
For its own I/O, CP uses the forward record zero pointer without 
performing a two-way check. Performing a two-way check would decrease 
performance and should not be necessary since all of the record zero 
pointers were checked in both directions by the Format/Allocate program 
(DMKFMT) when the CP-owned disk was originally formatted. 

Note: the DASD Dump/Restore (DDR) program also checks the record zero 
pointers both ways when a tape is restored to a disk. 

Except for those channel commands that deal specifically with the 
home address and record zero, any attempt to search or read or write on 
a track that is flagged as defective results in a unit check with "track 
condition check" indicated in the sense data. 

Operations on an assigned alternate track can also result in a unit 
check with "track condition check" indicated in the sense data. But in 
this case it occurs when an attempt is made to leave the assigned 
alternate track, not when the operation is reading or writing on the 
track- The situations where trying to leave the alternate track results 
in a track condition check are: 

• Any multi-track operation 

• A record overflow operation 

The hardware does no t generate a track condition check when a seek is 
used to leave the track. This applies to any kind of seek, including 
seek head. 

When a channel program from a virtual machine SIO (or from a 
Diagnose) is allowed to access an alternate track, subsequent CCHs in 
the channel program must be prevented from accessing adjacent tracks in 
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the alternate track cylinder since these may belong to other virtual 
machines. A channel program may attempt a transition from one track to 
the next by any of the following: 

• Seek 

• Seek head 

• Multi- track search or read 

• Record overflow 

The full seek causes no problem: since it specifies the cylinder as 
well as the track, it causes the channel program to leave the alternate 
track and to return to a cylinder within the minidisk extent. It is 
certain to go back to the minidisk because the seek address was verified 
when the virtual CCHs were translated to real. 

The multi-track operations and record overflow operations also cause 
no problem, because, as explained above, these are caught by the 
hardware and result in a track condition check. 

The seek head is dealt with as follows. When a seek to an alternate 
track is encountered in a virtual channel program by CP during the CCW 
translation process, CP converts all seek head commands (in the real, 
translated CCWs) to an invalid CCW opcode (X'FF'J. Then when the 
translated channel program is executed, it is interrupted (with a 
command reject) at each seek head CCW so that the track to which the 
channel program is seeking can be checked to see that it really belongs 
to the virtual machine that reguested the I/O. Note that this only 
happens to channel programs that seek out of the minidisk to an 
alternate track. 



Module Function and Control Flow 

DMKTRKVA - When DMKCCWTR finds a virtual machine seeking out of its 
minidisk extent to what should be an assigned alternate track, it has to 
do a check of the backward record zero pointer to verify that the 
alternate belongs to that minidisk. So DMKCCWTR calls DMKTRKVA, passing 
the CCHH address of the alternate as input, and DMKTRKVA performs CP I/O 
to read record zero of the alternate and then returns the pointer found 
in record zero to DMKCCWTR. 

DMKTRKFP - This is called by both DMKONT and DMKVIO. Its function is to 
handle command rejects in channel programs initiated by virtual machine 
SIO when the channel program was found (by DMKCCWTR) to be seeking to an 
alternate track outside the minidisk extent. The command rejects result 
because, for these channel programs, any seek head commands have been 
invalidated (opcode changed to X'FF*) in order to trap seek heads that 
might switch to another minidisk's track in the alternate track 
cylinder. 

Note: Even though DMKCCWTR may also find Diagnose I/O channel programs 
that seek directly to an alternate track and invalidate the seek head 
opcodes on these channel programs, the command rejects resulting from 
these channel programs are handled by DMKTRKIN, not by DMKTRKFP. 

DMKTRKIN - This routine performs alternate track recovery for CP I/O and 
for Diagnose I/O both when the Diagnose channel program results in a 
track condition check and when a command reject results from a seek head 
whose opcode DMKCCWTR made invalid. The routine has nothing to do with 
alternate track recovery for SIO issued by a virtual machine. But it 
does share a few small subroutines with DMKTRKFP. 
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DMKTRKIN is called only by DMKDASER, which in turn is called only by 
DMKIOS. These three routines work closely together during alternate 
track error recovery and the control flow back and forth between these 
routines is controlled to a great degree by flags in the IOBLOK and the 
IOERBLOK. 

The control blocks of major concern in this area are the RDEVBLOK, 
the IOBLOK, and the IOERBLOK. When an error occurs and DHKIOS makes the 
initial call to DHKDASER (at the time of the first error associated with 
this IOBLOK) , an IOERBLOK containing sense data has already been 
created; the IOBIOER field of the IOBLOK points to it. When DMKDASER 
gets control, it notices that this is a first call and it moves the 
pointer out of IOBIOER into RDEVIOER so that this first IOERBLOK, 
associated with the original error, can be kept over a period of time 
during which attempts may be made to retry the I/O operation. During 
these retries, further errors may cause new IOERBLOKs, pointed to by 
IOBIOER, to be sent back from DMKIOS, Generally speaking. RDEVIOER 
continues to point to the original IOERBLOK and new IOERBLOKs are 
created and sent back from DMKIOS after each retry that ends with an 
error. Generally, the new IOERBLOK from the failed retry is discarded 
before the next retry. But occasionally a new IOERBLOK is used by 
DMKDASER or DMKTRKIN to replace the original IOERBLOK, so it is pointed 
to by RDEVIOER and the first original IOERBLOK is discarded before the 
next retry. This happens when the new error is deemed to be more severe 
than the original (DMKDASER gives priority to channel checks) or when 
the original error gets corrected by a retry, but then the channel 
program fails on a later CCW (DMKTRKIH does this) . 

Control flow back and forth between DMKIOS and DMKDASER is controlled 
by the setting of the flags IOBERP, IOBRSTRT, and IOBFATAL, and has been 
described earlier in the section "DASD Error Recovery, ERP (DHKDAS). n 

The control flow back and forth between DMKDASER and DMKTRKIN is 
controlled by the flags IOERRDRO and IOERALTR and by a return code that 
DMKTRKIN passes back in register 1. Whenever either of the two flags is 
set, they cause DMKDASER to call DMKTRKIN whenever DMKDASER gets control 
(which in this case happens after a retry) , even though there is no 
track condition check indicated in the new IOERBLOK. The IOERRDRO flag 
indicates to DMKTRKIN that the retry being returned from was used to 
execute a channel program to read record zero. The IOERALTR flag 
indicates to DMKTRKIN that the retry being returned from is a restart of 
a user channel program (not strictly error recovery CCWs) that had a 
track condition check earlier. This means that invalidated seek head 
opcodes can be expected. 



Details of Alternate Track Recovery for CP I/O and Diagnose I/O 

Once a CP I/O or Diagnose I/O channel program has to be restarted 
because of a track condition check, the error recovery procedure 
invalidates (for Diagnose I/O only) all seek head opcodes in the channel 
program and sets the IOERALTR flag (indicating that alternate track 
error recovery is in progress) before proceeding. The IOERALTR flag 
remains set whenever any portion of the users channel program is being 
retried, until the channel program either ends successfully or ends with 
a permanent error. 

Note: The flag does not remain set continuously; there are breaks 
while the error recovery procedure takes time out to use its own channel 
program to read record zero (the channel program is passed back to IOS 
as a "retry"). At these times the IOERRDRO flag is set instead of the 
IOERALTR flag. 
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During the further execution of a Diagnose Channel program, 
invalidated seek head opcodes may be encountered once the IOERALTR flag 
is turned on. CP channel programs do not use seek head. The number of 
these opcodes encountered may be several, or none at all, depending on 
the user's channel program. Also, these invalidated seek heads may be 
trying to seek off of an assigned alternate track (usually to the next 
logical track) or they may have no involvement with flagged tracks at 
all, again depending on the nature of the user's channel program. 
Whenever the channel program is stopped by an invalidated seek head, a 
determination is made of whether or not it is trying to get off of an 
alternate track. This determination is made by looking at the current 
cylinder number (available in sense data taken at the time of the 
command reject) and seeing whether or not it falls within the alternate 
track cylinder area at the high end of the disk. If the seek head was 
not trying to get off of an alternate track, there is no problem and the 
subject channel program is restarted with a seek to the current cylinder 
and to the track specified by the invalidated seek head. If the seek 
head was trying to get off of an alternate track, record zero of the 
alternate track is read first to get the cylinder number of the 
defective track. Then the subject channel program is restarted with a 
seek to the cylinder of the defective track, but to the track specified 
by the invalidated seek head. 

TAPE ERROR RECOVERY, ERP (DMKTAP) 

Error recovery is attempted for user- initiated tape I/O operations to 
CP-supported devices that use the DIAGNOSE interface. The primary 
control blocks used for error recovery are the RDEVBLOK, the IOBLOK, and 
the IOERBLOK. In addition, auxiliary storage is used for recovery 
channel programs (repositioning and erase) . 

The interruption handler, DMKIOS, performs a SENSE operation when a 
unit check occurs. Tape errors are then passed to DHKTAP. The sense 
information associated with a unit check is contained in the IOERBLOK. 
If a channel check is encountered, the channel check interruption 
handler determines if retry is possible and passes control to the ERP 
through the I/O interruption handler. 

When an error is encountered and ERP receives control, DHKT1P 
determines if this is the first entry into the ERP for this task. The 
IOBRCNT (IOB error count) field of the IOB is zero on initial entry. On 
this first entry, the pointer to the IOERBLOK is placed in the RDEVIOER 
field of the RDEVBLOK. This preserves the original error CSW and sense 
information for recording. Thereafter, IOERBLOKS are discarded before a 
retry is attempted or a permanent error is passed to IOS. 

The ERP looks for two other specific conditions. If the error count 
field is not zero, entry must be due to a recovery attempt. Thus, it may 
be a solicited device end to correct an intervention-required condition 
or a retry attempt for either tape repositioning or channel program 
re-execution. 

The ERP keeps track of the number of retries in the IOBRCNT field of 
the IOBLOK to determine if a retry limit has been exceeded for a 
particular error. If the specified number of retries fails to correct 
the error, the error is recorded and DMKIOS is notified of the permanent 
error by turning on a status flag in the IOBLOK (IOBSTAT=IOBFATAL) . 

If the error is corrected by DMKTAP, the temporary error is not 
recorded and control is returned to DMKIOS with error flags all off. 
When repositioning is required in order to attempt recovery, additional 
ERP flags are contained in the IOERBLOK to indicate paths for specific 
errors (that is, data check on write must reposition, erase, and then 
reissue original channel program) . 
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All error recovery is started the same except for 
intervention-required errors. The IOBFLAG is turned on to indicate 
RESTART (IOBFLAG=IOBRSTRT) , and the IOBRCAW (IOBLOK Restart CAW) is 
filled with the restart channel address word. In addition, an IOBFLAG 
flag is turned on to indicate that the ERP is in control so that control 
can be returned to ERP during all tape error recovery (I0BFLAG=I0BERP) . 
In the case of an intervention required error, the ERP sends a aessage 
to the operator, and then returns to DMKIOS with indications that tell 
DMKIOS the ERP is waiting for a device end on this device. This is done 
by clearing the restart flag and returning to DMKIOS with only the 
IOBERP flag on. 

When ERP has determined a permanent error situation or successfully 
recovered from an error, all auxiliary storage obtained for recovery 
CCWs, buffers, and IOERBLOKs is freed before a return is made to DMKIOS 
(see Figure 22 for a summary of the IOB indicators) , also, the 
statistical counters for 2400, 3410, and 3420 devices are updated. 

If the error is uncorrectable or operator intervention is necessary, 
ERP calls the message writer to write the specific message. 



3270 REMOTE SUPPORT ERROR RECOVERY 

Recovery from errors associated with binary synchronous lines, and the 
related channel and transmission control unit hardware is processed by 
DMKBSC. Recovery from errors associated with data and control 
processing by the remote station (the device) as defined by remote 
status and sense byte definition (see IBM 3270 Information Display 
Component Description,) is processed by DMKRGF. Control blocks 
associated with these errors are the CONTASK, the RDEVBLOK, the BSCBLOK, 
the NICBLOK, the IOBLOK, and the IOERBLOK. 

The interruption handler, DMKIOS, performs a SENSE operation upon 
detection of a unit check condition (IOERBLOK) . The related sense data 
is analyzed as it relates to the previous operation (CONTASK or BSCBLOK, 
whichever is applicable) If a channel check is encountered by the 
channel check interruption handler, the channel check interruption 
(DMKBSC) procedures determine if recovery can be attempted. If it 
cannot be retried, that operation is aborted and an appropriate message 
is sent to the system operator. 

Depending upon the error encountered, ERP receives control and either 
DMKBSC or DMKGRA and DMKGRB determines if this is the first entry into 
the ERP for this task. The IOBRCNT (IOB error count) field of the IOB 
is zero on initial entry. On this first entry, the pointer to the 
IOERBLOK is placed in the RDEVIOER field of the RDEVBLOK. This 
preserves the original error CSW and sense information for recording. 
Thereafter, IOERBLOKs are discarded before a retry is attempted or a 
permanent error is passed to IOS. 

The ERP looks for two other specific conditions. If the error count 
field is not zero, entry must be due to a recovery attempt. Thus, it 
may be a solicited device end to correct an intervention-required 
condition or a retry of channel program execution. 

The ERP keeps track of the number of retries in the IOBRCNT field of 
the IOBLOK to determine if a retry limit has been exceeded for a 
particular error. If the specified number of retries fails to correct 
the error, the error is recorded and DMKIOS is notified of the permanent 
error by turning on a status flag in the IOBLOK (IOBSTAT=IOBFATAL) . 
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If the error is corrected, the temporary error is not recorded and 
control is returned to DMKIOS with all error flags off. 

When ERP has determined a permanent error situation or successfully 
recovered from an error, all auxiliary storage obtained for recovery 
CCWs, buffers, and IOERBLOKs is freed before a return is made to DHKIOS 
(see Figure 22 for a summary of the IOB indicators). Also, the 
statistical counters for 3270 are updated. 



The Attached Processor Environment 

Attached processor support is requested by specifying AP=YES on the 
SYSCOR macro. For a complete description of system generation 
considerations, see VM/370 Planning and System Generation Guide. 



CP Initialization for the Attached Processor 

IBM System/370 P rin ciples of Op eration , has a detailed discussion of 
prefixing that is necessary for understanding the initialization done 
for the attached processor. 



PROCESSOR ADDRESSES 

The CP initialization routine, DMKCPI, begins normal processing by 
storing the physical, main processor address — usually X'OO* — in the 
IPOADDR field in the PSA at location absolute zero. (Prefixing has not 
yet been established.) The logical processor address is computed by 
doing a logical OR of the physical address with X'40» and is stored in 
the PSA in LPUADDR. The logical value is used by the CP LOCK manager to 
avoid using a zero value. The physical value is used for signaling 
between the two processors. 

If AP=YES was coded on the SYSCOR macro, DMKCPI uses the SIGP 
function to see if the attached processor is available. If so, its 
physical and logical addresses are stored in the PSA in IPDADDRX and 
LPUADDRX, respectively. If the attached processor is not available, 
APONONLN is set to 1. If the multi- processing option is installed, 
message DMKCPI959W is sent to the operator. 



PSA SETUP 

The top two 4K pages of storage are marked (in the CORTABLE) as being 
CP-owned and are used as the PSAs for the two processors. The addresses 
of these two pages are stored at PREFIXA and PREFIXB in the PSA at 
location absolute zero. DMKAPI copies the information from the PSA at 
location absolute zero to the new PSA locations. In the PSA designated 
for the attached processor, PREFIXA and PREFIXB are switched. Thus, on 
either processor PREFIXA always represents the current processor and 
PREFIXB the other processor. The values of IPOADDR, LPOADDR, IPOADDRX, 
and LPUADDRX are also switched so that IPUADDR and LPUADDR always 
contain the processor addresses of the current processor and IPUADDRX 
and LPUADDRX contain the other processor addresses. 
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LOCKING 

To provide system integrity, VM/370 attached processor support is 
designed around one global system lock, a VMBLOK local lock, and several 
system local locks for specifically identified queues or modules. 



Global System Lock 

All of the control program runs under the global system lock except 
specifically identified paths. If the lock cannot be obtained, the 
function is deferred by storing the necessary information in the VMBLOK 
appendage and stacking that VMBLOK for later processing. That processor 
then takes a special unlocked path through the dispatcher to dispatch a 
new virtual machine. In some situations the processor cannot defer the 
requested function and spins on the lock until it becomes available. 

To ensure system integrity along the special unlocked paths, various 
local locks have been defined. These locks are basically spin locks and 
are held for short periods of time. 



VMBLOK Lock 

Each VMBLOK contains one lock, called VMLOCK, which is used by routines 
that need to serialize certain virtual machine related resources. These 
resources include the following: 

1. Any unlocked or unshared pages belonging to the virtual machine. 

2. Any of the unshared translation or backing store tables defining 
the address space of the virtual machine. 

3. Certain fields of the VMBLOK that are modified by routines that do 
not hold the system lock. Some of these fields are VHPSW, VHGPRS, 
and VMRSTAT. 

The dispatcher obtains the VMBLOK lock before a virtual machine is 
dispatched and also before a CP request or an I/O request is unstacked. 
When a virtual machine is dispatched, the VMBLOK address of this virtual 
machine is saved in the processor's PSA in the field RUHUSER. normally 
this virtual machine is also unlocked by the dispatcher when it is 
entered after an interrupt handler has finished processing. When 
RONUSER is still locked, the PSA field LASTDSER is equal to RONUSEB. 
When RUNUSER is unlocked, LASTUSER is set to ASYSVM. 

When a CP request or an I/O request is unstacked, the associated 
virtual machine is locked and the VMBLOK address is placed in register 
11. When the dispatcher is entered after a CP request or an I/O request 
has been serviced, the virtual machine whose VMBLOK address is in 
register 11 is locked and will be unlocked by the dispatcher. This 
virtual machine may not be the same virtual machine that was locked when 
the CP request or the I/O request was unstacked. 
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A CP routine must lock another virtual machine for any of the 
following reasons: 

1. The routine, or a routine it calls, accesses any unshared page of 
the virtual machine. 

2. The routine, or a routine it calls, alters any field of the VMBLOK 
that is serialized only by the VMBLOK lock. 

3. The routine, or a routine it calls, could be interrupted and an 
exit taken to the dispatcher. 

The original VMBLOK lock must be released before gaining the new 
lock. 

Figure 23 shows the modules that obtain the VMBLOK lock for a virtual 
machine other than the one requesting the service. 

There are situations when a CP routine may access a virtual machine 
without locking it. If the CP routine, or any routine it calls, is only 
altering VMBLOK fields that are serialized by the system lock, locking 
the virtual machine is not necessary. For example, to process the SET 
PRIORITY command for a virtual machine, locking the virtual machine is 
not necessary since the altered VMBLOK field, VMOPRIOR, is serialized by 
the system lock. But to process the SET FAVORED command, locking the 
virtual machine is necessary since some of the VHBLOK fields altered, 
such as VMRSTAT, are only serialized by the VMBLOK lock. 

DMKLOKFR _ Free Storage Lock 

DMKLOKRL - Run List Lock 

DMKLOKTR - Timer Request Queue Lock 

DMKLOKDS - Dispatcher Queues Lock 

- CPEXBLOK Queue Lock 

deferred execution blocks 
processor related blocks 

- IOBLOK/TRQBLOK Queue Lock 

These are system spin locks that are held for very short periods of 
time. The control program code that runs without the global system lock 
must manipulate these queues and these locks insure system integrity 
along the unlocked paths. 

2. ser- Defined Locks 

If you have user-defined areas that are used by more than one virtual 
machine and you need to serialize their use, you will need to define 
your own locking conventions. You can use the LOCK macro to obtain and 
release a PRIVATE lock. VM/370 System Programmer's Guide has details on 
how to code the LOCK macro. 

MACHINE CHECK HANDLER IN ATTACHED PROCESSOR 

A machine check interrupt is initially handled without the global system 
lock. DMKMCH determines if the error requires system termination, 
virtual machine termination, or simply recording and continuation. If 
the system was in a wait state or a virtual machine was in control and 
the system is not to be terminated, the machine check handler requests 
the global system lock with the defer option. If the lock can be 
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I Module 
j. 

DMKAPI 
DMKBLDVM 
DMKCFO 
DMKCNS 



DMKCPS 
DMKCPU 
DMKCPV 
DMKCSD 
DMKDIA 

DMKGRF 

DHKLOG 

DMKMID 
DMKMSG 
DMKMSW 
DMKNES 

DMKNLD 

DMKPAG 

DMKPTR 
DMKQCN 
DMKRGA 
DMKRGB 

DMKRNH 
DMKSPL 



DMKVCA 
DMKVCH 



DMKVDA 
DMKVDD 
DMKVMC 



uevice 



being 



Action 

Locks the virtual machine that was last dispatched. 
Locks the virtual machine just built. 
Locks the virtual machine being set as favored. 
Locks the virtual machine associated with a real 

block. 
Locks the virtual machine whose virtual device is 

reset when a real device is halted. 
Locks each virtual machine in order to prepare the VMBLOK 

for uniprocessor mode. 
Locks the virtual machine whose storage is being locked or 

unlocked, or for whom accounting is being done. 
Locks the virtual machine receiving transferred spool 

files. 
Locks the virtual machine of the dialed system, the virtual 

machine of the line being dropped (DMKDIABR) , or the 

virtual machine that owns the channel-to-channel adapter 

being coupled. 
Locks the virtual machine associated with a real device 

block. 
Locks the virtual machine being reconnected or the virtual 

machine being autologged. 
Locks the virtual machines receiving messages at midnight. 
Locks the virtual machine receiving a message. 
Locks the system operator. 
Locks each virtual machine active when the NETNORK SHUTDOWN 

command is processed. 
Locks the virtual machine associated with 

block. 
Locks the virtual machine associated 

request. 
Locks the virtual machine from which a 
Locks the system operator. 

Locks the virtual machine associated with a NICBLOK. 
Locks the virtual machine associated with a CONTASK or a 

NICBLOK. 
Locks the virtual machine of the destination user for a 

console task or the virtual machine associated with a 

remote teleprocessing line. 
Locks the virtual machine receiving a transferred spool 

file or the virtual machine owning a spooled reader 

file. 
Locks the virtual machine of the coupled-to CTCA. 
Locks the virtual machine to which the channel is being 

attached, or the the virtual machine from which the 

channel is being detached. 
Locks the virtual machine involved in attaching or 

detaching a real device. 
Locks the virtual machine involved in detaching a real 

device. 
Locks the virtual machine to which the caller is 

communicating . 



a real device 
with a queued I/O 
page will be stolen. 



Figure 23. Modules that Obtain Additional VMBLOK Lock 
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obtained, norial DMKMCH processing continues. If the lock cannot be 
obtained, DMKMCH stacks a CPEZBLOK with CPMCHLK set and exits to 
DMKDSPRU. This CPEXBLOK causes processing to resume at DMKMCHSE with the 
global system lock held. Any machine checks that occur before the 
CPEXBLOK processing has completed are considered recursive machine 
checks and handled appropriately. If the control program was in control 
and the system is not to be terminated, the machine check handler saves 
status in the CPEXBLOK, set CPMCHLK and reloads HCOPSW. CPMCHLK is set 
to prevent the dispatcher from starting any new work on this processor 
until the machine check processing has completed. 

DMKMCH passes control to DMKMCTPT if the system is running in 
attached processor mode and a decision has been made to terminate the 
system. In general, if a virtual machine was running when the machine 
check occurred, only that virtual machine is terminated. 

DMKMCTPT determines if the system can continue and if the processor 
can continue. For the attached processor, if the machine check was not 
a clock error and the control program was not in control, the virtual 
machine running at the time of the error is terminated. If the machine 
check was a clock error on the main processor or the control program was 
in control on either processor, the other processor is signalled to stop 
and store status and a wait state PSW is loaded on the failing 
processor. An attempt is made to issue message 610W to the operator 
before the main processor is stopped. If the machine check was a clock 
error on the attached processor and the control program was not in 
control, the main processor is signalled via an external call to 
initiate automatic processor recovery with an indicator to continue 
processing. 

The malfunction alert interrupt handler (DMKHCTMA) receives control 
from the external second level interrupt handler. If the malfunction 
alert came from the main processor, a 001 wait state PSW is loaded. If 
the malfunction alert came from the attached processor and a virtual 
machine was in control, an indication is set to terminate the virtual 
user and CPAPRPND is set for processor recovery. If the attached 
processor was in supervisor state, message 610W is sent to the operator 
and a 013 wait state PSW is loaded. If the attached processor was in a 
wait state, CPAPRPND is set for processor recovery. 

The automatic processor recovery routine (DMKMCTPR) receives control 
from the external SLIH or the dispatcher. If the system is to continue 
processing, the vary processor offline routne (DMKCPODP) is called. 
DMKCPODP examines the chain of virtual machines for attached processor 
affinity and shared segment pointers. Any shared segment pointers for 
the attached processor are switched to point to the main processor 
shared segments. All the system control blocks and save areas necessary 
to run in attached processor mode are also freed. The time from the 
first timer request gueue element is placed into the clock comparator 
for the main processor. 

While preserving the maintained fields in the absolute zero area, the 
main processor's prefix storage area is copied to the absolute zero area 
and prefixing is stopped. The attached processor operational flag is 
turned off in the absolute zero area, and the prefix storage areas for 
the main and attached processors are freed. The pages and DASD slots 
held by the attached processor for shared segments are freed by DMKPGT 
and DMKPTR. A message (1941) is issued, and return is made to DMKMCTPR. 
For any virtual machines with affinity to the attached processor, 
DMKMCTPR resets the affinity for each, issues message 6211, and puts the 
machine in console function mode (if the virtual machine is not 
disconnected). If a virtual machine is to be terminated, the virtual 
machine is reset, messages 6161 and 6191 issued. Normal return causes 
the system to continue processing in uniprocessor mode. 
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The action that, the machine check handler takes for a given situation 
is determined by the error itself, the operating environment of VH/370, 
and whether the system was performing a CP function or a virtual machine 
function — or the system was not performing at all (a loaded wait state 
condition when the error occurred) . Figure 24 clarifies the action the 
system takes for the given situations- 



r 1 

| | VM/370 Processing | Virtual Machine Processing | 


j Error Condition | uniprocessor | attached processor j uniprocessor | attached processor | 


j 1 j Main | Attached j | Main I attached | 


I Invalid machine | 1 1 1 1 1 1 1 |1|1| 
j check interrupt! Ill I I I 
j code ! III I!! 


I Invalid PSW | 1 |1|1| 1 |3|3| 
I data | III III 


I Register, j | I 1 I 1 I 1 I 3 | 3 | 
I Program mask | III III 
j instruction | III III 
| address invalid! Ill III 


| System damages | 1 I 1 I 1 I 1 I 3 | 3 | 


J TOD or CPO | 1 I 1 I 1 I 1 J 1 | 3,4 | 
! Clock Errors | III III 


IMultibit | 1 | 1 | 1 | 3,2 | 3,2 | 3,2 | 
I (solid) Storage! Ill III 
| error | III III 


IMultibit | 1 I 1 I 1 I 3,2 | 3,2 | 3,2 | 
j (intermittent) j III III 
I storage error j j j j j | j 


I Storage Protect | 1 j j 1 j j 1 | 3 j 3 | 3 | 
(Key (solid) ) ill i I i 
I failure j III III 


I Storage Protect! 2 |2|2| 2 | 2 | 2 | 
I (intermittent) | III III 
I failure j III III 


I Malfunction | 5 | 1 | 1 | 5 I 1 I 3,4 | 
I alert | III III 


I Channel | 1 | 1 | 1 | 1 | 1 | 1 | 
I inoperative | j | j III 


I Legend: I 
| 1 = load wait state PSW I 
I 2 = refresh for retry operation ! 
I 3 = terminate the virtual machine I 
j 4 - automatic processor recovery I 
I 5 = Not applicable I 



Figure 24. Condition/Action Table for Uncorrectable Errors 
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Multip rocessor External Interrupts 

For external interrupts that can occur in attached processor mode 
(tiae-of-day sync check, malfunction alert, external call, and emergency 
signal), DMKPSAEX gives control to DMKEXTSL. DHKEXTSL does the 
following for each kind of interrupt: 

Malfunction alert 

• Call DMKMCTMA, which will either load a disabled wait state on the 
appropriate processor or initiate automatic processor recovery, to 
allow the system to run in uniprocessor mode. If a user was running 
at the time of the malfunction alert he is terminated. 

SHUTDOWN Emergency Signal 

Issued to the attached processor prior to shutting the system down. 

• Turn off APUOPER in each PSA to indicate that the attached processor 
is not operational. 

• Load a 008 disabled wait PSH. 

• Disable channel zero. 

• Pass control to the dispatcher at DMKDSPRU. 
QUIESCE Emergency Signal 

• Give control to the dispatcher at DHKDSPRD, which will load a wait 
PSW that is enabled for external calls only. 

SYNC Emergency Signal 

Issued by DMKCLKMP when the clocks are no longer synchronized (low order 
synchronization) . 

• Give control to DMKCLKAP to synchronize the clock on the attached 
processor. If the set clock fails, the attached processor is 
terminated with a CLK003 abend. 

CLKCHK Emergency Signal 

• Give control to DMKCLKCC. If the clock on the attached processor is 
not synchronized with the main processor (high order synchronization) 
or is not set, then a flag is set to cause DMKCLKMP on the main 
processor to synchronize the clocks. The attached processor is then 
put in a wait state enabled for external interrupts. If the clock is 
not working, the attached processor is terminated with a CLK003 
abend. 

APR External Call 

• Give control to DMKMCTPR to allow the system to run in uniprocessor 
mode. 

RESUME External Call 
Cancels a previous QUIESCE. 

• Give control to the dispatcher at DMKDSPRU. 
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WAKEUP External Call 
"wake-up" an idle processor. 

• If the system was running a user, reload the external old PSW. 

• If the system was not running a user, then try to obtain the SYSTEM 
lock. 

• If the SYSTEM lock is obtained, give control to the dispatcher at 
DMKDSPCH. 

• If the lock is not obtained, give control to the dispatcher at 
DMKDSPRU. 

DISPATCH External Call 

Inform the other processor of a processor related CPEXBLOK. 

• Try to obtain the global system lock. 

• If the system lock is obtained, go to the dispatcher at DMKDSPCH. 

• If the lock is not obtained and the system was in a wait state, go to 
DMKDSPRU. 

• If the lock was not obtained and the system was not in a wait state, 
reload the external old PSW. 

Time-of-Day SYNC Check 

• Call DMKCLKSC. DMKCLKSC signals the attached processor to quiesce. 
It then sends message DMKCLK970W to the operator and calls DMKCLKHP. 
DMKCLKMP issues a SYNC emergency signal to synchronize the clocks. 
DMKCLKSC issues a RESUME signal to allow the attached processor to 
continue. 

• If the SYSTEM lock is held, go to the dispatcher at DMKDSPCH. 

• If the SYSTEM lock is not held, go to the dispatcher at DMKDSPRU. 

I/O Subsystem 

The I/O subsystem of ¥M/370 runs under the global system lock on either 
the main processor (processor with I/O capability) or the attached 
processor (processor without I/O capability) . The I/O first level 
interrupt handler (DMKIOSIN) is the only exception; it runs unlocked 
during its normal error free processing. The main processor owns all 
real I/O blocks (RCHBLOK, RCUBLOK and RDEVBLOK) . DMKIOSIN always runs on 
the main processor because only the main processor can receive I/O 
interrupts. All other routines that set any fields within the real I/O 
control blocks or that are dependent upon the status of a real I/O 
control block remaining static, must use the SNITCH macro to force their 
processing to the main processor. All routines within DMKIOS with the 
exception of DMKIOSRH, reissue the SWITCH macro whenever loss of control 
is a possibility, to ensure that processing remains on the main 
processor. 

The SWITCH macro tests to see if it is running on the attached 
processor or the main processor. If it is running on the attached 
processor it issues an SVC 24 to transfer control to the main processor 
and to resuie execution at the next sequential instruction. 
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If DMKIOS receives an unsolicited interrupt or an I/O error for 
scheduled I/O, a call is made to DHKFREE for either an IOBLOK, CPEXBLOK, 
or an IOERBLOK. DMKFREE will ensure that control is returned to the 
processor that initiated the request. 



Shared Segment 

The shared segment suuf unction of VH/370 (DHKATS, DHKCFG, DHKCFH, 
DHKPGS, and DHKVHA) runs under the global system lock on either the main 
processor or the attached processor. All protected shared segments are 
duplicated in a system that is generated for attached processor mode and 
that is initialized on a machine with the multiprocessing feature. 
DHKCFG obtains sufficient storage to construct the duplicate page and 
swap tables in contiguous storage. The SHRTABLE SHRPAGE pointer points 
to the page and swap tables for the main processor, and the page and 
swap tables for the attached processor are at a fixed displacement from 
the page and swap tables for the main processor. DHKCFG initializes 
both sets of page and swap tables. Initially, the two swap tables point 
to the DASD locations specified in DHKSNT. However, as the pages are 
read into storage and then stolen, each shared page is allocated its own 
DASD slot and is pointed to by only one swap table entry. 

The last user to purge a shared system causes both sets of page and 
swap tables to be released. 

One shared page table is reserved for use by each processor. This 
includes both problem state and supervisor state execution on behalf of 
a virtual machine. To accomplish this, each time a virtual machine 
running a shared system is locked, a test is made to determine whether 
or not the virtual machine was last serviced on this processor. If it 
was last serviced on the other processor, all of its shared page table 
pointers in its segment tables are switched to this processor's shared 
pages. 

DHKPTR is able to steal a shared page from a shared page table 
reserved for the processor it is running on without notifying the other 
processor. The virtual page could not appear in the look-aside buffer 
of the other processor. 

The dispatcher releases the VHBLOK lock on LASTOSER following the 
check for pending interrupts (assuming no fast redispatch possible) 
unless the virtual machine was running one or more shared systems. In 
the latter case the VHBLOK lock is not released until the DHKVHA scan 
for a changed page is completed. 

DHKVHA scans all protected shared segments that the virtual machine 
used. For every changed page that it finds, DHKVHA checks whether or 
not the system lock is held. If the system lock is held, the changed 
page is returned to CP free storage. If the system lock is not held, 
DHKVHA marks the page table entry as invalid, marks the swap table entry 
as in transit, and indicates that the core table entry is on the free 
and flush lists. The other virtual machines can continue to use the 
shared segments. The changed pages are replaced when the next reference 
to the changed page is made. 

If the shared segment is violated, an error message (DHKVHA456) is 
sent to the violator, and he is placed in console function mode. The 
user may examine his PSW and registers to determine what caused the 
violation. The user enters the BEGIN command to resume execution at the 
point of interruption. 
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CP Method of Operation and Program 
Organization 



This part contains the following information: 

• CP Program Organization 

• Dse of the Annotated Flow Diagram 

• Virtual I/O Operations and Interruption Processes 
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CP Program Organization 



Use of the Annotated Flow/ Diagram 

The following text sections, which describe each major CP function, are 
annotated flow diagrams. These diagrams, consisting of logic labels and 
commentary, describe the general flow and use of CP logic modules and 
their relationship to other modules while performing a specific function 
or task. The annotated flow diagrams do not contain references to error 
messages, abnormal termination conditions, or most control block field 
labels. This avoids complexity and makes the general logic of CP and 
its related tasks more understandable to the user. With 
!S understandability f? as the key, obtuse and complex logic that is used 
for obscure and seldom used functions is not described. Also the flow 
diagram does not indicate nor describe every entry point encountered in 
a function. Nor do the diagrams illustrate the innumerable times that 
commonly used modules are utilized. DMKFRE and DMKCVT, the obtaining 
and returning of free storage and the number base conversion modules are 
such examples. Annotated flow diagrams are arranged by function and 
subfunction. Titles for these functions and subfunctions also precede 
annotated flow text and labels. The text in the charts is prefixed by 
underscored and capitalized entry points and labels. Entry points are 
indicated by seven or eight characters; the first three characters are 
DMK. Labels are indicated by prefixing with a comma and the 
six-character module identification. 

The annotated flow diagrams in this section do not reflect VH/370 use 
of the MSS. If there is an MSS attached to the VH/370 system, consult 
Appendix B in this volume for flow diagrams of those functions that 
utilize the MSS (such as logging on a virtual machine that has a 
mimidisk defined on an MSS 3330V volume) . 

Note : Annotated flow diagrams are not to be construed as trace material. 
The dynamics of CP operations preclude the use of the annotated flow 
diagrams, as they are shown in this manual, as traces of CP functions. 



VM/370 CP Interruption Processing 

SVC INTERRUPTIONS - PROBLEM STATE 

DMKSVCIN 

Entry for SVC interruptions from problem or supervisor states. For 

problem node and ADSTOP (SVC X 'BS')* the overlaid instruction is 

replaced. 
DMKCFMBK 

Console function mode is entered. 
DMKSVC IN 

For problem state SVC 76 (X'UC) check for valid parameter passing. 
DMKVERD. DMKVERO 

Determine the operating SCP used in the virtual machine by examining 

passed parameters in R0 and R1. 
DMKSVC, SVCVER 

For invalid parameter passing, error recording is not performed. 
DM KIOEVR 

The SVC is reflected to the user. 
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DMKIOFVR 

On correct parameter reflection, record the error. 
DMKSVC, REFSVCB 

REFSVCB is called if TRACE SVC was in effect or if the virtual 

machine 1 s page zero is not in real storage. Obtains the system lock 

before continuing. If the system lock is not immediately available, 

REFSVCB defers the interrupt and exits to DMKDSPRU. 
D MKTRC SV 

The DMKTRC module is called if TRACE SVC was invoked. 
DMKPRGRF 

If tracing is not active, flag user as being in instruction wait 

state and reflect the SVC back to the user. 
DMKSVC 

If the virtual machine's page zero is in real storage, generate and 

store an old SVC PSW. Fetch the new SVC PSH. If there is no PSW state 

change, store user's new PSW in RUNPSW, restore registers and 

dispatch via LPSH. 
DMKSVC, REFSVCA 

If there is a PSW state change, obtain the system lock before 

continuing. If the system lock is not immediately available, defer 

the interrupt and exit to DHKDSPRD. 
DMKDSPB 

Check the altered PSW. 



SVC INTERRUPTIONS - SUPERVISOR STATE 

DMKSVC, SVCDIE 

Entry is for a system failure and is a SVC or SVC 4 abend 

condition. 
D MKDMP DK 

Perform partial or full real storage dump. 
DMKCKPT 

Checkpoint the system. 
DMKCPINT 

Perform an automatic IPL if indicated. 
DMKSVC, SVCLINK 

Entry via SVC 8 provides linkage to a called routine in R15. 
DMKPTRUL 

If called routine is not resident, page it in and return control to 

the caller by loading the SAVERTN into the old PSW and then load the 

old PSW. The caller's addressability, SAVEAREA address and return 

address are maintained in a new SAVEAREA. 
DMKSVC, SVC RET 

Entry via SVC 12 return control from the called routine to the 

calling routine and restores addressability via R12 and R13. 
DMKPTRUL 

If a nonresident module, unlock page to return it to DASD. 
DMKSVC, SVCRLSE 

Entry via SVC 16 to release the current SAVEAREA used by SVC 8 and 

12. Return to caller. 
DMKSVC, SVC GET 

Entry via SVC 20 to obtain a new SAVEAREA. Return to caller. 
MESVC, SVCSWIT 

Entry via SVC 24 to switch control to the main processor. 

EXTERNAL AND CLOCK INTERRUPTION REFLECTION 

PMKPSAEX 

Entered via the interruption key on system console, adjust accounting 
to charge for supervisor overhead. If problem mode, attention 
interruption, update the virtual machine PSW from the external old 
PSW. 
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DMKPSA, EXTBUTTN 

Exit to dispatcher, if there is no logged-on operator, or the 

operator is disconnected, or there is no active terminal. If the 

operator was logged on and the external interruption key was pressed, 

disconnect the operator's terminal. 
DHKQCNCL 

Clear ail console requests. 
DHKSCHRD 

If the device is a terminal or graphic device, issue HIO to the real 

device. 
DMKDSPCH 

Exit to the dispatcher. 
DMKPSA, EXTBOTTN 

For 3704/3705, convert resource identifier for the NCP terminal for 

the indexable entry into the NICBLOK for the associated VMBLOK, then 
DMKRNHND 

Reset all BTUs. 
DMKDSPCH 

Exit to the dispatcher. 
DMKPSA, EXT EXT D 

Upon location X'80* timer interruption, indicate the user end of the 

time slice by storing flag in the VMBLOK's VMOSTAT. 
DMKDSPCH, DMKpSPRU 

If the system lock is held or is available, exit to the main entry of 

the dispatcher, DMKDSPCH. Otherwise, exit to DMKDSPRD. 
DMKPSA, EXT TIMER 

Upon processor timer interruption, VMTLEVEL in VHBLOK as a real 

processor timer interruption. 
DMKTMRVT 

Simulate the interruption. 
DMKDSPCH, DMKDSPRU 

If the system lock is held or is available, exit to the main entry of 

the dispatcher, DMKDSPCH. Otherwise, exit to DMKDSPRD. 
DMKPSA, EXTCKC 

Upon clock comparator interruption reflection 
DMKSCHTQ 

Use the printer to unchain the active TRQBLOK. Call DMKSTKIO. 
DMKSTKIO 

Stack the block. 
DMKDSPCH, DMKDSPRU 

If the system lock is held or is available, exit to the main entry of 

the dispatcher, DMKDSPCH. Otherwise, exit to DfiKDSPRG. 



MONITOR INTERRUPTION PROCESSING 



DMKMON 

The VM Monitor data collection component uses both sample and trace 
techniques. Selected system counters are sampled by routines entered 
periodically via TRQBLOK. Selected events are traced upon execution 
via monitor call instructions embedded at strategic points in the 
control program. 

PMKMOHTI 

TRQBLOK gives control here every 60 seconds (unless specified 
otherwise with the MONITOR INTERVAL command) , and a new TRQBLOK is 
immediately stacked via call to DMKSCHST, to request a return to the 
same entry point 60 seconds later. Control register 8 monitor mask 
is used to determine which of the three sampled data classes 
(PERFORM, USER, DASTAP) are enabled. Appropriate counters are 
sampled using special subroutines for each class and the data is 
stored in the monitor buffers. Upon completion, goes to dispatcher. 
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Class Code Data Items Collected 

Software and hardware utilisation, contention, and 
activity counters 
1 Corresponding items for APD 
4 ?MBLOK user resource consumption and status 
6 0,1 DASD and tape activity counters 

DMKENTTI 

Entered via TRQBLOK every two seconds (unless specified otherwise 
with the MONITOR INTERVAL command) . A new TRQBLOK is immediately 
stacked via a call to DMKSCHST to specify return of control to the 
same entry point two seconds later. This subroutine is a high 
frequency (relative to the PERFORM, USER, DASTAP sampler) I/O status 
sampler. All channels are tested for a busy condition with a TCH 
instruction. All control units and devices are tested for a busy 
condition by examining the appropriate CP control blocks. The data 
obtained is accumulated for later sampling by the DASTAP class of 
data collection in a class 6 (DASTAP) code 2 (I/O status) record. 
The subroutine DMKENT62 performs this collection after the standard 
class 6 (DASTAP) code 1 record has been collected by MONCOD61 in 
DMKMONTI. 

DMKMONMI 

Entered from DMKPRG after a monitor call in a class currently enabled 
(as defined in CR 8 mask) has been executed by CP in supervisor 
state. The monitor call instruction number and code number stored by 
the hardware in the PSA are used to index branch tables to reach the 
appropriate data collection routines. As necessary, the data is 
stored in the monitor I/O buffers before output. Upon completion, 
control returns to instruction after monitor call. 

Activity Being Monitore d 

Begin console read 

Console output 

End console read 

Console sleep 

Oser dropped from queue 

User added to queue 

User added to eligible list 

Privileged instruction being simulated 

SIO for DASD SEEK 

Add queue, drop queue - more detailed resource 

consumption data 

DMKMONPR 

All data collection subroutines use a common buffer management 
subroutine to obtain sufficient space in the monitor buffers. When 
not enough space is available, a switch is made to the next buffer in 
the chain and the full buffer is scheduled for output via a CPEXBLOK. 
I/O is handled by DMKIOSQR if tape is in use, or by DMKHIAWO if a 
spool file is in use. If data collection gets ahead of buffer output 
and all the monitor buffers are filled, a temporary suspension 
occurs. 

DMKMONIO 

Handles normal and abnormal completion of buffer output to disk or 
tape. For normal completion, the buffer used for I/O is made 
available for further data collection; if the next buffer is already 
full, its output is immediately scheduled. If a suspension was in 
effect, data collection is immediately resumed using the freed 
buffer. (Note: Suspensions should be eliminated by increasing the 
buffer allocation, using the MONITOR command or the SYSMON macro.) 
Special tape conditions that can be handled include end of tape and 
permanent error. 
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Class 
1 


Code 





1 




2 




3 


2 


2 




3 




4 


5 





7 





8 






DMKENTKC 

Entered via CPEXBLOK at midnight if automatic monitoring to spool 
file is in effect and it is required to close out the current file 
and continue monitoring with a new file. DMKENT satisfies the 
nucleus residency requirements of CPEXBLOK entry point and acts as a 
stepping stone to DMKMIA. Goes to DMKDSP after successful call to 
DMKMIAKC. 

DMKMIAKC 

Sets up a request to invoke a MONITOR CLOSE command in DMKMCCCL. 

DMKMCCCL 

Executes MONITOR CLOSE command and calls DMKMIACC to complete 
processing. 

DMKMIACC 

Invoked by the MONITOR CLOSE command to close the spool file and 
chain the spool file block to the reader of the virtual machine where 
data reduction is to take place. Starts new spool file if 
appropriate. 

DMKENTST 

Entered via TRQBLOK due to previous determination by automatic 
monitoring facilities that a MONITOR START SPOOL command should be 
issued. This entry satisfies the need for CP nucleus residency and 
immediately calls the pageable DMKMIAIN. 

DMKMIAIN 

Builds a message buffer containing a MONITOR START SPOOL command and 
calls DMKMCCCL. 

DMKMCCCL 

Executes MONITOR START SPOOL command. DMKENTST gives control to 
DMKDSP after successful execution. 

DMKENTET 

Entered via TRQBLOK due to previous determination by automatic 
monitoring facilities that a MONITOR STOP command should be issued at 
this time. This entry satisfies the need for CP nucleus residency 
and immediately calls the pageable DMKMIAEN. 

DMKMIAEN 

Buils a message buffer containing a MONITOR STOP command and calls 
DMKMCCCL. 

DMKMCCCL 

Executes MONITOR STOP command. DMKENTET gives control to the 
dispatcher after successful execution. 

DMKMIAST 

Entered from DMKCPI when it is determined that automatic monitoring 
has been requested via the SYSMON macro in DMKSYS and that TRQBLOKs 
should be queued via calls to DMKSCHST to invoke a MONITOR START 
SPOOL command and a MONITOR STOP command at specified times in the 
future. If monitoring is required to start immediately because the 
start time has passed, a CPEXBLOK is built to give control to 
DMKENTSC, which invokes the DMKMIAIN mechanism described above. 

All other DMKMCC, DMKMNI and DMKMIA entry points are used as a result 
of the processing of MONITOR commands or special conditions. 

Three Class monitor call codes have been reserved for special 
purposes. They are used without actually executing monitor calls, but 
as a result of MONITOR command processing. They are: 

C lass Co d e Function 

"~0 97 Write header record after MONITOR START command 

98 Write trailer record after MONITOR STOP command 

99 Write suspension record when data collection resumes 
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PROGRAM INTERRUPTION PROCESSING 

DMKPRGIN 

For a program interruption received while in supervisor node 

(indication of CP module error) and INTRDR+1 does not indicate 

MONITOR CALL (X'UO') exit to - 
DMKPRG, CP ERROR 

Send abend message to the system operator. 
DMKDMKPK 

Dump storage and initiate loading (via IPL) . 
DMKPRGIN 

For supervisor state and MONITOR CALL save registers in in DMKPRGPR. 
DMKPRGMI 

Do MONITOR CALL interruption processing (DMKMON) . 
DMKPRG, PRNSTAT 

For paging exception X'11' and EC mode with translation on call 

DMKVATEX. 
DMKVATEX 

Process the exception. 
DMKPRGIM 

For paging exception, x '11' and EC mode with translation off, and 

enabled for I/O interrupts and PAGEX on call DMKVATPF. 
DMKVATPF 

Process the pseudo page fault. 
DMKPRG, PAGEX CP 

For all other page fault conditions go to DMKPTRAN. 
DMKPRG, OBSLOCK 

The system lock must be obtained before DMKPTRAN is called. If the 

system lock is not immediately available, defer the interrupt and 

exit to DMKDSPRO. 
DMKPTRAN 

Bring in the page from the auxiliary device. 
D MKDSP CH 

Exit to dispatcher. 
DMKPRG, PRNSTAT 

For segment exception X'10 1 with EC mode on and translation on call 

DMKVATSX. 
DMKVATSX 

Process the exception. 
DMKPRG, PR G SIM I 

For the segment exception, X'10 1 does not follow the above 

parameters; process it as an addressing exception. 
DMKPRG. TRANS EX 

Process X*12* translation exceptions. 
DMKPRG, PRG01 

For privileged or operational exception of a virtual machine in 

supervisor mode, examine ITRPR+1 if X'01 1 or , 02 l call DMKPRVLG. 
DMKPRVLG 

Process the exception. 
DMKPRV, DMKPRGSM 

For virtual machines in problem mode, store the users new program PSN 

in VMBLOK VMPSH. 
PMKPSASV 

When the program interrupt occurs and the users page is not 

resident or the virutal machine is in EC mode, paging is performed. 
DMKDSPB 

Check the new PSH. 

Validate the privileged operation indicated in VHINST and perform the 
service. 
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Code 



X 


•08* 


X 


'09» 


X 


•44* 


X 


'80 1 


X 


■82« 


X 


•9C« 


X' 


■9D» 


X 


i 9E f 


X 


ig F i 


X 


»AC» 


X 


»AD' 


X 


»B1» 


X 


»B202» 


X 


•B203' 


X 


»B204» 


X 


'B206» 


X 


•B207' 


X 


»B208« 


X 


•B209» 


X 


B20A« 


X 


•B20B» 


X 1 


B20D« 


X 


»B6* 


X 


■B7« 


X 


»BA» 


X 


'BB 1 



Operation 

SSK - Set storage key 

ISK - Insert storage key 

EX - Execute instruction 

SSM - Set system mask 

LPSH - Load PSW 

SIO - Start I/O 

TIO - Test I/O 

HIO - Halt I/O 

TCH - Test Channel 

STNSM - Store, then AND system nask 

STOSM - Store, then OR system mask 

LRA - Load real address 

STIDP - Store processor ID 

STIDC - Store channel ID 

SCK - Set TOD clock 

SCKC - Set TOD clock comparator 

STCKC - Store TOD clock comparator 

SPT - Set CPU timer 

STPT - Store CPU timer 

SPKA - Set PSW key from address 

IPK - Insert PSW key 

PTLB - Purge TLB 

STCTL - Store control registers 

LCTL - Load control registers 

CS - Compare and swap 

CDS - Compare double and swap 



DMKPRV, LOCKET 

The system lock must be obtained before other supervisor routines are 

called. If the system lock is not immediately available, defer the 

interrupt and exit to DMKDSPRU. 
DMKHVCAL 

On privileged operations of DIAGNOSE X^a* and the associated 

function code, perform the service. 
DMKYSIEX 

Execute privileged I/O operations of SIO, HIO, TIO and TCH. 
DMKTHRTN 

Perform privileged operations related to TOD clock, TOD clock 

comparator and the processor timer. 
DMKPRGSM 

Program interruption is reflected back to the user on invalid 

instruction operands, unsupported instruction operand codes and 

DIAGNOSE •SB' function codes that are not a multiple of 4. 

Virtual I/O Operations and Interruption Processes 



CTCA OPERATIONS BETWEEN TWO VIRTUAL MACHINES 



DMKYSIEX 

Virtual I/O operation is reflected to DMKVCA, the channel adapter 

module, for processing. 
DMKVCAST 

For SIO, check if the CTCA is coupled. If not coupled, call 

DMKDIASM. 
DMKDIASM 

Simulate return status. 
DMKVCA, VCRSTART 

For a coupled CTCA, analyze operations resulting in X-side (read) and 

I-side (write) of the data transfer operation. 
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DM£I£!' YCASIOB 

Detected interruptions are presented to users via stacked IOBLOKs and 

DMKSTKIO. 
DMKVCATS 

CTCA TIO activity is determined by examining Y-side information to 

determine mode and activity. 
DMKVCASH 

CTCA HIO and HDV is processed by determining the conition code to 

present and whether the Y-side should be notified. 
DMKVCARD 

CTCA process results from RESET xxx or SYSTEM RESET commands. The 

CTCA status is reset but the CTCAs are not uncoupled. 
DMKVCARS 

Uncoupling CTCA is achieved in the VDEVBLOK (VDEVNRDY flag) idle CTCA 

plus an invoked DETACH xxx or user LOGOFF. Return to calling 

routine. 



SCHEDULING I/O FOR CP AND THE VIRTUAL MACHINE 

DMKIOSQR 

Entered via SVC. Entry point indicate a CP I/O event as indicated in 
the IOBLOK. For start request, increment the SIO count in the 
RDEVBLOK and start the device if it is available. If not (device 
busy or already scheduled) queue the IOBLOK and return the operation 
to the caller. 

DMKIOSQ.V 

Entered via SVC. Entry point indicates virtual machine initiated I/O 
event. Preserve VMBLOK address in R11, turn off IOBCP bit in the 
IOBLOK, add 1 to SIO count in the VDEVBLOK (or RDEVBLOK) . Process 
the SIO if there is any available path to the device. If not, queue 
the IOBLOK and return the operation to the caller. 



STANDARD DASD I/O INITIATED VIA DIAGNOSE 

DMKDGDDK 

Perform simple disk I/O of a standard format. Entry is via DMKHVC 

code X f 18» . 
DMKSCNVU 

Find device related to SIO cuu address. 
DMKFREE 

Allocate storage for IOBLOK and RCWTASK. 
DMKGDDK 

Build and check the CCW string. 
DMKIOSO.V 

Execute I/O. On completion, post condition code (and error return 

code in R15, if detected). 
DMKDSPCH 

Exit to dispatcher. 
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GENERAL I/O OPERATION INITIATED VIA DIAGNOSE 

DMKGIOEX 

Perform general I/O operation- Entry is via DMKHVC code 20. 
DMKSCNVU 

Find device related to SIO cuu address. 
DMKFREE 

Allocate storage for the IOBLOK. 
DMKCCHTR 

Build the read CCW list. 
DMKIOSQV 

Queue the I/O request for execution. 
£HE<iIQ r DIAGRTN 

On interruption return, check status. 
DHKUNTFR 

If no problem encountered, free storage used for CCS string and 

IOBLOK. 
DMKGIO, DIAGRTN 

Reflect the condition code and return code to the user. 
DMKDSPCH 

Exit to dispatcher. 
DMKONTRN 

On returned error condition, convert real CSfl to virtual CSW and set 

in user's page 0. 
DMKGIO, GIOEXT 

Exit via SVC 12. 



VIRTUAL MACHINE I/O INSTRUCTION SIMULATION AND INTERRUPTION REFLECTION 
I/O Instruction S imu lation 

DMKVSIEX 

Entry from DMKPRV to simulate I/O per VMBLOK's VMINST field. 
DMISI, VIQSIO 

On detected SIO, call - 
DMKSCNVU 

To locate VCHBLOK, VCUBLOK, and VDEVBLOK for the cuu called per SIO 

instruction* 
DMKVSIEX 

Determine device availability and set condition code accordingly. 
DMKIOSQV 

If the operation is warranted, schedule the operation. 
DMKVSI, VIOTIO 

For TIO, check device status, pending interrupts, and set appropriate 

condition codes. 
DMKVSI, VIOHIO 

For HIO, check for dedicated channel, CE, CU, or device busy 

condition, and subchannel busy and set appropriate condition codes. 
JDHKVSI, VIOTCH 

Check for dedicated selector or busy channel and check for pending 

abnormal interruption and set appropriate condition code. 
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Interruption Re flec tion 

DMKVIOIN 

Entry froa DMKDSP to process the reflected virtual interruption. 
DMKSCNVU 

Locate the VCHBLOK, VCUBLOK, and VDEVBLOK. 
DMKVIOIN 

Analyze blocks and reflect condition code to user. If condition code 

equals 1 (cc=1) , save status from the real device (if real device) 

and DMKUNTFR. 
DMKUNTFR 

Translate and store CSW in user's page 0. 
DMKVIO. VI0CC1 

On TIO or HIO, free the device and set CC=1. 
DMKFRET 

Fret storage for the IOBLOK. 
DMKDSPCH 

Exit to dispatcher. 

VIRTUAL CONSOLE SIMULATION 

DMKYSIEX 

Entry for virtual console activity cones froa the SCP stored in the 

user's virtual machine. The program's generated CCWs and data are 

reflected to the attached terminal used by the virtual machine 

operator. 
DMKVCN EX 

Locate and move non-TIC CCWs from the users virtual storage to a 

VCONCTL block. 
DMKVCN, GETCCH 

Update CAW and CSW in respective control block. 
DMKVCN, VCNgD 

For read operation, build a read console buffer VCONBUF for the input 

to be read from the terminal. 
DMKQCNRD 

Queue a console read request. 
DMKVCNEX 

Set return address in VCONCTL VCNRDRET field. 
DMKVSPVP 

Spool console activity if SPOOL CONSOLE START specified. 
DMKDSP CH 

Exit to dispatcher. Wait for completion. 
DMKVCN . VCNWR 

Calculate and obtain free storage (VCONBUF) necessary for the write 

to console operation. 
DMKVCN. VCNMDAT 

Translate and bring in user's data page and move it into VCONBUF. 
DMKQCNWT 

Queue a console write request. 
DMKDSPCH 

Exit to dispatcher. 
DMKVCN. VCNSNCN 

ON a sense operation, set CE and DE in the virtual PSW. Reflect the 

PCI flag in the PSW if the PCI flag was set in the CCW. Set the IL 

flag if warranted. Move the sense data from the VDEVBLOK to user 

storage as designated by the CCW. Update VDEVBLOK's VDEVCSW to 

reflect status and count. 
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DMKVCN, YGHCC1 

On completion of I/O operation, set appropriate status for command 
reject, not ready protection check, incorrect length, channel program 
check. Set appropriate CC and CSW in users page 0. Otherwise post 
pending interruption status in VMBLOK, VCHBLOK, VCUBLOK, and 
VDEVBLOK. 

DMKVCN, FLA GT EST 

If command chaining, process the next CCW. 

DM KDSP CH 

Exit to dispatcher. 

LOCAL GRAPHIC I/O AND INTERRUPTION PROCESSING 

DHKGRFEN 

Entry for local graphic device enable and disable function (from 
DMKCPVEN and unstacked CPEXBLOK) . Invoking CP ENABLE/DISABLE 
commands, start or terminate local 3270 display (and supported print 
devices) and certain system console activity. 

DBKFREE 

Performs enabling function. Gets storage for IOBLOK and TRQBLOK 
generation. 

DMKGRF, LOG USER 

Form and write out the logo at the screen. 

DMKGRF, ATTN INT 

Unsolicited attention for RDEVBLOK (enabled) . 

DMKBLDVM 

Build LOGON VMBLOK for logon process. 

DMKCFMBK 

Enter console function mode for terminal input. 

DMKIOSQR 

Schedule request to clear screen preparatory to logon. 

DMKDSPCH 

Exit to dispatcher to wait for interruption. Successful logon per 
the next interruption begins the operation of building the user's 
virtual machine. 

DMKSCNRU 

From the IOBLOK, locate the real device blocks related to the 
interruption. Analyze IOBLOK CSW and condition code and the I/O 
operation to determine read/write sequential action. For unit error, 
retry 10 times (if applicable). If recovery fails, log off. For 
ATTN interruptions, attempt to log on the new user if unsolicited 
ATTN occurs. Otherwise, set up for READ CCW string. 

DMKFREE 

Get storage for function and build CONTASK, IOBLOK, TRQBLOK. 

DMKIOSQR 

Issue the SIO. 

DMKDSPCH 

Wait for the response. 

DMKGRFIN 

Local 3270 display and certain system console interruption entry from 
dispatcher. On response of CE and DE, go to auxiliary processing 
routine address in TRQBLOK extension TRQBCRT and execute the 
processing routines: 

Routine Function 

CONRETBF Completion of a write CONTASK 

RDMINT Completion of a buffer read 

GRFCFM Execute console function 

SETREJ Set no accepted timer 

SETMOR Set more... timer delay 

SETWNG Set 10 second clear warning 

RDEXIT Clear buffers after PF keys 

STRTREAD Set read status 

NOCTL Process next CONTASK or go idle 
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DMKGRF, RDATA 

Process read response of data plus ENTER key. 
DMKCNSED 

Edit and modify length count. Move data to caller's buffer. 
DMKfiCNHT 

Schedule rewrite to screen (unless inhibited) . 
DMKIOSQR 

Perform start I/O. 
DMKDSPCH 

Exit to dispatcher. 
DMKGRFIC 

Entry point to process CONTASKS queue for local 3270 and 3066 

devices. 
DMKFREE 

Get storage for IOBLOK and TRQBLOK. 
DMKGRF, BLDCCWS 

Execute CONTASK, if appropriate. If not - 
DMKDSPCH 

Exit to dispatcher. 
DMKGRF, RDM1N1 

For read return, determine function key action and write response (if 

appropriate) via KEYTEL. 
DMKGRFTI 

Entry point for processing timer interrupts. 



LOCATE AND VALIDATE AN ISAM READ SEQUENCE 

DMKISMTR 

Entry from DMKCCW modules to locate and modify an ISAM CCW string. 

Osing the IOBLOKs IOBCAH locate the RCWTASK. Check for the ISAM read 

CCW. 
PMKISM, CHKRD 

Check for the correct ISAM sequence as follows: 

1. The last CCW in the RCWTASK is a TIC. 

2. This RCWTASK points to the next RCWTASK with a linimum of 2 
CCWs. 

3. The first modified CCW is in real storage. 

4. The last byte of the ISAM read overlays the operation code of 
the first CCW in the next RCWTASK. 

5. The TIC in the RCWTASK is to the next RCWTASK*s first CCW. 

6. The date address of the first CCW in the next RCWTASK is the 
same address of the ISAM read+1 as it is in real storage. 

DMKFREE 

Storage obtained for seven double words save block. 
DMKISM, CHKTSK2 

Institute the ISAM read modification as follows: 

1. Set the read to point to the save block data area. 

2. Set the CP TIC to point to the modified CCW in the same block. 

3. Set the modified CCW (seek head) in the save block to point to 
the save block data area. 

4. Set the CP TIC in the save block to return to the RCWTASK 
following the modified (seek head) CCW. 

5. Set the search CCW in the RCWTASK to point to the data area in 
the same block. 
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DODBLEWORD SAVE BLOCK 



1 — - - ' - -' ■' — 1 

I Bead Address I (2) TIC Address | 


I Unused | 
1 ' 




I Bead Data Area 




I | (3) Modified CCW | 


I (4) TIC to RCWTASK | 


I Real Bead CCW j 


I Beal TIC CCW 

L 





DMKISM, CHKTSK2 

Return to DMKCCW module via SVC 12. 



SCHEDULING CP 
HANDLING 



AND VIRTUAL MACHINE I/O OPERATIONS AND INTERRUPTION 



DMKIOSQR 

Entry to process CP generated I/O. Flag the IOBLOK as a CP generated 
event. Initiate I/O if path to real device is free (available) . If 
not, queue the IOBLOK and return to caller. 

DMKIOSQV 

Entry to process I/O for virtual aachine I/O operations. Mark IOBLOK 
as not CP initiated. Save VMBLOK address. If path to the VDEVBLOK 
or the VDEVBLOK is busy queue the IOBLOK and return to caller. 

DMKIOS, IOSTATDV 

If available status, start the I/O and return to caller. 



SIO Ope rati ons 



DMKIOS, 10 B ST ART 

If I/O request has not been reset, save the address of the active 

IOBLOK and set device busy. If the device is being reset, unflag 

scheduled device and scheduled control unit. Stack the IOBLOK and 

restart the device. 
DMKIOS, IOSS 10 

Set the subchannel path busy and chain the active IOBLOK froa the 

RDEVBLOK. 
DMKIOS, IOSSIO 

Locate caller»s CAW and issue the SIO. Check SIO coipletion. 

Returned condition code sets sequel action. 

cc = indicates successful start 

cc = 1 CCW stored, initiate sense operation 

cc = 2 Busy condition, retry or requeue IOBLOK 

cc = 3 Fatal error (not operational) , stack the IOBLOK and return to 
caller 
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HIO Operations 

DHKIOSHA 

Entry point for halting a device. If device is not active, return to 
caller. If IOBLOK active, reset the IOBLOK to halt the device and 
mark the device reset in RDEVBLOK. 

DMKIOS, 10 3 10 K I 

If the channel path is busy with a burst mode operation, stack the 
IOBLOK to halt the operation when the channel path becomes available. 
Return to caller. 

Interruption P rocess ing 

DMKIOSIN 

Entry from I/O new PSW. Check old PSW. If problem mode, save 

processor status in the VMBLOK. 
DHKSCNRN 

Locate RCHBLOK, RCDBLOK, and RDEVBLOKs for interruption unit. 
DMKYIOIH 

Process dedicated channel interruption condition. If control unit 

end or channel available interruption occurs, restart the operation, 

if interruption does not occur stack it. 
DMKIOSIN 

~ If the IOBLOK is not active on RDEVBLOK interruption, call DMKIOS. 
DMKIOS, IOSENSE 

Schedule sense operation, then go to dispatcher. 
DMKIOS, IOSRSTRT 

For PCI or CE interruptions, copy and stack the IOBLOK. 
DMKCHSIN 

Process PCI or CE interruptions, if related to local graphic device 

or nondedicated TP line. 
DMKIOS, DOS ESSE 

For split seek complete interrupt, rechain the seek and reschedule 

operations. 
DMKSTKIO 

Stack IOBLOK and restart any units freed by the interruptions. 
DMKDSPCH, DMKDSPA 

If the system lock is held or is available, exit to the main entry of 

the dispatcher, DMKDSPCH. Otherwise, exit to DMKDSPA to try to 

redispatch ROHUSER. 



TERMINAL CONSOLE I/O CONTROL, START/STOP, 3210, 3215, AND OTHERS 
Enabling/Disabling 

DMKCNSEN 

Per unstacked CPEXBLOK, on enable or disable function, check current 
status of the current real device and set flag in RDEVFLAG. Build 
CONTASK and IOBLOK. 

DMKIOSQR 

Issue SIO for enabling or disabling function and check return. 
DMKDSPCH 

Exit~to dispatcher. 
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Process CONTASK data 

DMKCNSIC 

Entry from DMKQCN module- Build I/O CCW string as defined by the 

console device type. Also select the proper line code to interface 
with the device. Place in CONTASK. For output CONTASK determine the 

correct translation table applicable to terminal communications 

(DMKTBL) . To append proper control character to the data stream for 

the particular device type, refer to the following labels: 

• DMKCNS, INCWTTY 
Teletypewriters 

• MECNS, INC 27 41 
2741, 3767 

• DMKCNS, INC 10 50 
"1050, 1051 

• DMKCNS, INC3210 
3210, 3215 

MKCNS, INC FINS 

Attempt to start I/O by halting the current operation, if the 

operation is a "prepare" CCH or the input is a read and the 

forthcoming output is a priority write CONTASK. 
DMKFREE 

Get storage to build IOBLOK, if needed. 
DMKCNSIN 

Set return address in IOBIRA. 
DMKIOSQR 

Start I/O. If busy condition encountered build CPEXBLOK and queue for 

later execution. 
DMKDSPCH 

Exit to dispatcher. 

St art/ Stop Terminal Interruption Proces s 

DMKCNSIN, CM BREAK 

For an active input task halted, RDEVFLAG=RDEVHIO to process priority 

DMKFREE 

Build CONTASK for reverse break CCHs. 
DMKCNS, CNS BREAK 

Move the input CONTASK following the last priority write output 

CONTASK on the chain. 
DMKCNS, CNS 100 C 

For unit check with intervention required, assume an attention 

interruption and build a "prepare" CCN for the 2741. 
DMKCNS, CNSLOGF 

For unit check and timeout condition - logoff the virtual machine and 

re- enable the line. 
DMKCNS, CNSRTRY 

For data check and other conditions, retry the previous operation. 
PMKC0.NET 

Process completed output CONTASK. 
DMKCNSIN 

Interpret interruption status and CCW residual count for input 

CONTASK completion. 
DMKCNS, CNINCT 

Validate input data and control characters and translate to EBCDIC 

from line code. 
DMKTRMID 

Attempt to identify, if applicable, the line code identification; 

PTTC/EBCD or correspondence. 
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DMKCNSED 

Perform line editing of the input buffer. 
DMKCNS, CNSRT41 

Prepare and issue control GCWs to request status information froi the 

terminal. 



Proc essing the Control COHTASK I nte rruption 

DMKCNSIN, CNSCTAK 

For control task interruption return, examine the interruption status 
according to control task function: 

• DMKCNS, CHSTAK 
Reset control task. 

• DMKCNS, CNSCTID 
Device identification. 

• DMKCNS. CNSCTPR 
Attention signal. 

DMKCNS, CNSC TPR 

Write "VM/370 Online" interpretation of response determines retry, or 
build new CONTASK and execute or stack or process next CONTASK. 

DMKQCNET 

Process completed CONTASK reguests. If no tasks remain for the 
terminal, set IOBLOK»s IOBIRA to DMKCNSIN and link the IOBLOK to the 
user. 

DM KDSP CH 

Exit to dispatcher. 

CONSOLE SCHEDULING 

PMKO.CNRD 

SVC entry to build CONTASK for input data. Set the input buffer to 

zeros. 
DMKFREE 

Get storage to build CONTASK. 
D MKQC N. ENQUEUE 

Stack CONTASK on RDEVBLOK, if RDEVCON was zero. If not, exit to the 

appropriate interrupt handler per RDEVTYPC and RDEVTYPE or - 
DMKSPCH 

Exit to dispatcher. 
DMKQCNWT 

SVC entry to build CONTASK for output data. Strip trailing blanks 

from output message, modify byte count and determine real device 

destination. 
DMKFRE E 

Get storage to build output CONTASK. 
DMKQCN. fRDSCK 

Update CONTASK CCH message byte count for the message text, terminal 

and line control information and (if appropriate) time stamp. 
DMKCVTDT 

If time stamp reguired, get the value for CONDATA area. 
DMKVSPVP 

Spool console message, if VDEVFLAG=VDEVCSPL. 
DMKQCN. CRSCAN1 

If message data contains carriage returns, X'15*, create a separate 

CONTASK for each line. 
DMKO.CN, WAKEUPR 

On first CONTASK or priority CONTASK, enqueue on chain from RDEVBLOK 

in appropriate location, then call related interrupt handler. 



1-198 IBM VM/370 System Logic and Problem Determination — Volume 1 



DMKQCN, WAKEMUP 

If NORET or DEFRET specified, build and stack CPEXBLOK to alert the 

interruption handler and return via EXIT SVC otherwise go to 

specified interruption handler. 
DMKQCNTO 

Entry via SVC to disconnect and logoff a virtual machine as a result 

of transmission line failures. Place the virtual machine in a wait 

state, VMRSTAT=VMCFWAIT. 
DMKSCHDL 

Alter virtual machine to unrunnable state. 
DMKFREE 

Get storage for message for the system operator. 
DMKSCNRN, DMKSCNRD, DMKCVTBH, DMKSYSNM 

Fill in message variables. 
DMKSCNR, DMKSCNRD. MECVTBB, DMKSYSHM 

Fill in message variables. 

Send the user disconnect message to the operator. 
DMKQCN, DSCGTRQ 

Build TRQBLOK, if needed, for 15 minute delay, schedule it, and exit 

via SVC. 
DMKQCN. DSCTLOG 

After time elapse, TRQBLOK is unstacked and VMOSTAT is set to VMKILL 

for inevitable DMKDSOFF logoff operation. 
DMKDSPCH 

Exit to dispatcher. 



3704/3705 INTERRUPTION HANDLER 

DMKRNHIC 

Entry via DMKQCN or via CPEXBLOK for 3704/3705 resource 

initialization. Locate the NICBLOK and check resource avaiability. 
DMKRNH, LINEBRK 

For resource unavailable, set RC=12 in CONTASK save area and return 

task via DMKQCNET. 
DMKRNH, TAGTASK 

For resource available, set CONTASK values per input and output task 

requirements. 
DMKRNH, TASK EN Q 

Move CONTASK from RDEVBLOK chain to NICBLOK chain. 
DMKRNH, RNSTART 

On 3704/3705 available condition, search NICLIST and build an IOBLCK 

if required. 
DMKRNHIC. RNEXLST 

Search the NICBLOKs for CONTASKs to be sent to 3704/3705, build and 

chain for output. 
DMKRNH, RN CHAIN 

Perform necessary function for each resource. 
DMKIOSQR 

Start output I/O operations. 
DMKRNH, RNICHN1 

Return via R7. 
DMKRNHNI) 

Entry via SVC to schedule resource control tasks. 
D MKRNH . RNHNDTK 

Build control CONTASK and enqueue it for execution. 
DMKRNH, STKCPEX 

For NORET specified, build and stack a CPEXBLOK to perform SVC exit. 
DMKRNH. RNDEXIT 

Attempt to start output via GOTO DMKRNHIC. 
DMKRNH, RNFDISC 

Entry for~3704/3705 recovery. 
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DMKNLDR 

Load the 3704/3705, if it was not previously loaded. 
DMKFRE 

Get storage to build CKPBLOK (telecommunications control block) , if 

necessary. 
DMKRNH, RNSBITS 

Record active line and enabled terminal flag bits. 
DMKfiCNET 

Clear CONTASK chains. 
DMKfiCNTO 

Force disconnect to all active users. 
DMKNLEMP 

DUMP the 3704/3705. 
DMKNLDR 

Reload the named program. 
DMKRNHND 

On "IPL complete" signal, reenable resources. 
DMKFRET 

Release the CPEXBLOK. 
DMKDSPCH 

Exit to dispatcher. 
DMKRNHIN 

Entry via IOBLOK to perform input and output interruption processing. 
DMKRHK, RNIOERR 

For input process failure. Analy2e the failure and if related to the 

3704/3705 and not to a particular resource, either retry or dump and 

reload. 
DMKRNH, READBUT 

Interpret response codes for each BT0 received and schedule necessary 

control operations. 
DMKRN H, CMP READ 

Generate response to a read error. 
DMKRNH* CMP WRITE 

Generate response to a write error. 
DMKRNH, CMP CO NT 

Generate response to a contact task error. 
DMKRNH, COM DISC 

Generate response to a disconnect task error. 
DMKRNH, COMCNTL 

Generate response to a control task error. 
DMKRNH, ON SOL IT 

Generate response to a unsolicited read. 
DMK0.CNET 

Return completed CONTASKs. 
DMKRNH, RNSTART 

Attempt to restart the 3704/3705. 
DMKDSPCH 

Exit to the dispatcher. 
DMKRNHIN 

Entry via IOBLOK to perform input and output interruption processing. 
DMKRNH, SCHREAD 

On output, examine interrupt status per IOBLOK values and if ATTN, 

build and start a read CCW sequence. 
DMKRNH* RNJOEOC: 

If unit check and fatal, dump and reload the 3704/3705. 
DMKRNH, RN08J1P 

If pending ATTN cleared via SIO - 
DMKI0S£R 

Reschedule write operations. 
DMKRNH, RNSLQWDN 

If~unit exception, set RDEVSLON and reschedule rejected CONTASKs. 
DMKQCNET 

Return only CONTASKs without CONRESP or CONSPLT set. Retain others 

until final response is received. 
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DMKRNH, RNSTART 

Attempt to restart the 3704/3705. 
DMKDSPCH 

Exit to dispatcher. 



HANDLING REMOTE 3270 WITH BINARY SYNCHRONODS LINES 

Remote Diplay Station a nd Binary Sy nchronous Line Enabling /Di s abli ng 

DHKRGBEN 

Entered when the NETWORK ENABLE/DISABLE command is issued. 
DMKFREE 

Get storage for the necessary CONTASK, IOBLOK, and if applicable, 

BSCBLOK. 
DMKRGB, LINES DP 

Set up required CCWs and control data in the CONTASK for tasks. 

These tasks include: enabling the binary synchronous line, enabling a 

device, LOGO messages, screen formatting, and disable line or device 

(logoff) . 
DMKFREE 

For logon function build logon VMBLOK. 
DMKIOSQR 

Start line I/O or device I/O, for not busy condition. 
DMKRGB, RGFTASK 

For busy condition, build CPEXBLOK and exit to caller. 



Request Handler for 3270 I/O Events 

DMKRGBIC 

Entry from DMKDSP. On a not available line condition, exit to 

dispatch. For available line, process the associated CONTASKs by 

queueing the related resource from the NICBLOK. 
DMKIOS, RGSTART 

Process POLL SIO on a no CONTASK queued condition. 
DMKIOSQR 

Process selection SIO on available resources and not in control mode 

per NICBLOK conditions and the CONTASK CONSTAT field. 
D MKDSP CH 

Exit to dispatcher. 



Seco nda ry Interruption Processor for 3270 

DMKRGA IN 

Entry from DMKIOS, examine line interruption condition. Discard any 

of the following and go to the dispatcher: nonbinary synchronous 

line, copied IOBLOK, unsolicited interruption, bisync line flagged 

not-in-use, nonterminal class device. 
DMKRGA, FATAL ER 

For IOBFATAL condition or any nonzero condition code, free all 

related CONTASK, IOBLOK, IOERBLOK, and BSCBLOK. 
DMKRGA, DISASTA 

Log off all affected users on that line. 
DMKMSWR 

Send message to the system operator. 
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DMKDSPCH 

Exit to dispatcher. 
DMKRGAIN 

If line or terminal response did not fall in the previous category, 

process via TP code branch. The code in the fifth byte of the ending 

CCW or IOBCSW-8. 

TP Code Function 

TPOO Error Handling CCW 

TP01 Enable/disable function 

TP02 Write EOT (sequence prior to polling and addressing) 

TP03 Write polling or addressing characters 

TP04 Handle station's status and sense message 

TP05 Read response to addressing 

TP06 Write response to text 

TP07 NO-OP following POLL command 

TP08 Dnit exception condition (timeout) 

TP09 All reset commands 

TP10 Read/write text 

TP11 Read response to text 

DMKDSPCH 

Exit to the dispatcher. 

3 270 Bin ary Synchronous Line Error Recovery 

DMKBSCER 

Entry via DMKIOS and SVC 8 to process errors related to the binary 

synchronous line unit check and channel error conditions. On first 

error pass, move the IOERBLOK pointer from the IOBLOK to the 

RDEVBLOK, reset retry and fatal flags, set the ERP flag and call 

DMKFREE. 
DMKFREE 

Get free storage for a work area for retry CCWs. 
DMKBSC. NOT FIR ST 

On a not first error condition, test for unrecoverable error 

condition. Unrecoverable errors include: 

program check, protection check, chaining check, equipment check, 

interface control check and channel control checks. If one of these, 

notify the system operator. Reset flags, initiate error recording 

and 
DMKFREE 

Free IOERBLOK. 
DMKIOSQR 

Go back to scheduler. 
DMKRGA 

Analyze TP code, sense data CSW residual count and retry count to 

determine retry or IOBFATAL flag setting. 
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REAL STORAGE ALLOCATION AND PAGE MANAGEMENT 

Process a Pa.ge Reque st 

DMKPTRAN 

Enter via the TRANS MACRO per paging request as determined by DAT 

created program interrupt (page or segment exception) . 
DMKPTR RESTART 

Return to caller, if virtual address in R1 is beyond range of user's 

directory specified storage size. 
DMKPTR, ADDROK 

Check page residency via LRA (LOAD REAL ADDRESS) operation. 
DMKPTR, TESTLOCK 

For resident page, lock page in storage (if appropriate) . 
DMKPTR, GET R ADD 

Set real address in R2, make PAGTABLE entry valid. Set cc=0 and exit 

to caller. 
DMKPTR, INT RAN 

For page not resident but in transit (SWPTABLE, SWPFLAG) , place 

virtual machine in locate mode. Locate CPEXBLOK for the real page 

requested and chain another CPEXBLOK with a return address of 

TRANRETN, to the same chain. 
DMKPTR, TRANRETN 

After page is no longer in transit, restore registers and return to 

RESTART for processing. 
DMKPTR, GETPAGE 

Reclaims a page on FREELIST (CORETABLE) . 
DMKPTR, DO 10 

For page that is not in storage, do setup to read in the page. 
DMKPTR, CKDEFER 

For DEFER option passed in R2, build CPEXBLOK to return to user after 

page is in storage. 
DMKPTR, PAG IN 

After the page is read into storage DMKPAGIO process, remove the user 

from the wait state and update the lock count (if required) . 
DMKPTR, GET R ADD 

Set real address in R2, make PAGTABLE entry valid. Set cc=0 and exit 

to caller. 

Obtain, Ret urn, Lock and Unlock a Page of Free Storage 

DMKPTRFR 

Per the caller's code in R2, obtain a page frame - 

DMKPTR, GET FREE 

Obtain page frame via CORTABLE reference then exit to caller. 

DMKPTRFE 

Entry via CPEXBLOK, check page availability via flush list 
(DMKPTRFL), if none available steal a user's page. 

DMKPTR, SELECT 

The SELECT routine is entered to replenish the FREELIST from the 
flush list or user's pages that have not been referenced. 

D MKPTR FT 

Process pages to be returned by chaining them to the FREELIST. On 
page returns DEFER page requests are processed first. 

DMKPTRLK 

In locking a page in Real Storage (address in R2) , add 1 to lock 
count; if previously locked, and exit to caller. If not previously 
locked, unchain the CORTABLE entry from the user's page list and set 
the lock count to 1. 

DMKPTROL 

To unlock a locked page, reduce lock count by 1 and exit. If the 
lock count is now equal to zero, place CORTABLE entry on user's page 
list prior to exiting from routine. 
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READING/WRITING A DASD PAGE TO/FROM VIRTUAL STORAGE 
Virtual Storage and Management - Non-EC Mode 

DMKRPAGT 

Entered via SVC call to read DASD page into storage. 
DMKPGTPR 

Release DASD space that was previously occupied by this virtual 

storage page. 
DMKRPA, RESIDENT 

Remove resident page frames from the user list. 
DHKPTRFT 

Place these page frames on the free list. 
DMKRPA, STORDASD 

Update the SHPTABLE with disk address in RO. 
DMKPTRAN 

Bring the page into storage. 
DMKRPA , EXIT 

Put real storage address of the virtual page is passed back to the 

caller in R2. 
DMKRPAT 

Entered via SVC call to write out a page to DASD storage. 
DMKPTRAN 

Locate the page to be moved and lock it. 
DMKRPAPT 

Store all registers in CPEXBLOK and flag CPEXRO as a write request. 
DHKPAGIO 

Write the page. 
DMKRPA, IORETN 

Decrement page wait count. If zero results, take user out of page 

wait. 
DMKPTRUL 

Unlock the page frame. Return to caller. 



Virtual Storage Mana g ement - EC Mod e 

DMKVATAB 

Entry via BALR when an EC mode virtual machine needs a shadow table 

generation and update or purge operation. 
DMKVATMD 

Get storage to create shadow table. Flag VMBLOK to show shadow table 

ezistance. 
DMKVATBC 

Free shadow page, segment and copy segment, when user leaves EC mode 

or alters CR 0. 
DMKVATRN 

Entry to perform third level to first level translations and third 

level translations to second level address translations. Use TRANS 

macro to access virtual segment and page tables to get the virtual 

page into real storage. 
DMKVATLA 

Using the TRANS macro to access the virtual segment and page tables, 

pass the resulting page and displacement to DMKPRVLG. 
DMKVATPX 

Invoked by DMKPRGIN when a paging exception is received for an EC 

mode virtual machine. 
DMKVAT. SET UP EX 

Perform set up operation and develop page table address. 
DMKPTRAN 

Get the page. 
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DHKVATPX 

Update the shadow table. 
DMKVATSX 

Invoked by DMKPRGIN when a segment exception is received for an EC 

mode virtual machine. 
DMKVAT. SET UP EX 

Perform setup operation, then invalidate the shadow page table or if 

none exists, allocate a new shadow table and set it invalid. 
DMKVATPF 

Entered via DMKVATPG from DMKPRG to simulate pseudo page fault 

interrupts when a paging exception occurs with pseudo page fault 

interrupts enabled. 
DMKPTRAN 

Bring in the DASD page. 
DMKPRGSK 

Reflect program check X'HM to the user. 
DHKVAT, PAGRES 

When the page becomes resident in storage. Build the PGBLOK, set 

high order bit in the translation exception address field, 
DMKDSPCH 

Exit to dispatcher. 

ALLOCATION AND DEALLOCATION OF DASD SPACE 

DMKPGTPG 

Entry to search and allocate a DASD page for paging/spooling. 

DMKPGTSG 

Search appropriate RECBLOK chain for available DASD page. If none 
found, locate next available cylinder and construct a new RECBLOK, 
calculate address of the allocated DASD page and place it in R1. 
Return to caller. 

DMKPGTPR 

Entry to deallocate DASD page used for paging and spooling. Via 
RDEVBLOK locate the RECBLOK and reset appropriate bit in the RECBLOKs 
RECMAP and adjust the member of DASD pages in use. If all the pages 
on the DASD cylinder have been deallocated, deallocate the cylinder. 
Exit to caller. 

DMKPGTSR 

Entry to release a group of DASD pages no longer needed for spool 
file use. Per R1, find RECBLOK and dummy RECBLOKs and reset the 
RECHAP bits as specified. Free related RECBLOKS, if complete 
deallocation occurs. 

DHKPGTCG 

Entry for allocation of enough DASD spool space to record a 3704/3705 
dump. Scan RDEVBLOK and associated ALOCBLOK for enough contiguous 
available space to record the dump. When found, flag cylinder as 
allocated and build and chain the required RECBLOKs. 

PJJKPGTVG 

DMKPGT contains an internal table, PAGETABL, in which the allocation 
of page frames for the CP paging VMBLOK is kept. The PAGETABL is 
scanned for a zero bit denoting the page frame is available. The 
page is marked allocated by setting the bit to one and the address of 
the page frame is returned to the caller in R1. If no page frames 
are available, a CPEXBLOK is built and queued to the deferred request 
chain. 

DHKPGTVG 

Entry to release a page of virtual storage. Check the chain of 
deferred requests. If there are none, reset the page bit in the 
PAGETBL to and exit to the caller. Otherwise, give the page to the 
first requestor in the deferred chain and stack his CPEXBLOK for the 
dispatcher. 
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SHARED SEGMENT STORAGE MANAGEMENT 

DMKATSCF 

Entry via SVC from the command processor if an ADSTOP, TRACE, or 

STORE command is to alter a shared page. The virtual machine issuing 

the CP command will be unshared from the named system, that is, given 

a private copy. 
DMKERMSG 

The running virtual machine is informed of the share page violation. 
DMKVMASH 

Entered from DMPDSP or DMKPTR via BALR. The protected shared page 

tables are examined for hardware change bit being on. The resulting 

condition code is reflected to the caller. 
DMKVMASW 

Entered to switch the virtual machine from one set of page tables to 

the other. 



TEMPORARY DISK STORAGE MANAGEMENT 

D MKTDK GT 

Entry to allocate temporary disk space (T-disk) . Nith RO equal to 
the number of cylinders required and R1 equal to the device type, 
locate RDEYBLOK and related ALOCBLO^s ALOCMAP. If no allocation 
space is to be found, return to caller with in R8. If allocation 
is successful, flag ALOCMAP, with X*AA» as allocated and put first 
cylinder address in R1 and RDEVBLOK pointer in R8 and return to 
caller. 



PAGING I/O SCHEDULER 

DMKPAGIO 

Entry to initiate Page I/O activity. Using Preformatted IOBLOK from 

IOBSTACK, fill in the CCWs with DASD opcode and values derived from 

CPEXBLOK swap table and core table. Chain the CPEXBLOK on the 

in- transit queue. 
DMKPAG, GETRDEV 

Find the Paging RDEVBLOK. 
DMKPAG, FIND 10 B 

Search IOBLOKs seeking the same cylinder address. If found, chain 

the channel programs together with TICs. 
DMKDSPCH 

Exit to the dispatcher. 
DMKPAG, QUEUED 10 

If no IOBLOKs with some cylinder address are found - 
DMKI0S0.R 

Start the I/O operation. 
DMKDSPCH 

Exit to the dispatcher to await interrupt. 
DMKPAG, UNTRANS 

Upon interrupt return, unchain the CPEXBLOK from the intransit queue. 
DMKSTPCP 

Stack all deferred requests for execution. 
DMKPAG, UN STACK 3 

Return IOBLOK to IOBSTACK or free it. 
DMKPAG, OVERHEAD 

Calculate paging load and store it, the TOD, and other values in PSA. 
DMKDSPC H 

Exit to dispatcher. 
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RELEASE VIRTUAL STORAGE PAGES 

DMKPGSSS 

Entry to release partial virtual storage. Per R1 (address of first 

page to be released) and R2 (address of last page to be released) set 

partial entry flag- 
DM KPGS PO 

Entry to check for shared segments and decrement usage count. Store 

registers and flag full entry condition- Examine VMSHRSIS for shared 

segments. If so, decrement use count. On zero use count unchain the 

SHRTABLE from the active list. 
DMKPGS, CK CLEAR 

On NOCEAR exit to caller. If not, store number of release pages in 

R8. 
DMKPGS, PG0DT2 

Locate page and swap tables for the segment to be released and index 

to the entry for the first page. 
DMKPTRAN 

Initiate paging, and when paging stops release the page frame. 
DMKPGS, NEXTPAGE 

8 value. 
DMKDSPCH 

Exit to caller. 

DMKPGSPS 

Entry to release storage containing a named system passed by the 
caller. If register one is nonzero, search the page tables looking 
for a header equal to the named system. If found, release the swap 
and page tables and build new ones, if the address range still lies 
within the user's virtual storage size. If register one is zero, 
release and rebuild swap and segment tables for all segments above 
the normal virtual storage size that do not have SHRTABLE entries. 



FREE STORAGE MANAGEMENT 

DMKFREE 

Entry to obtain a block of storage, validate input doubleword request 

DMKFRE, FREESUB 

ON subpool size request, index into SUBTABLE. For correct size block 
found, remove block from chain and put the address of the block in 
R1. Return to caller. 

DMKFRE, FREE 02 

For subpool size not found get next large subpool size. Remove block 
from chain, put address in R1 and return to caller. 

DMKFRE TRYSPLIT 

For subpool that cannot honor request, start search a 30 doubleword 
end for block requirement. When a block is found, split block (if 
necessary) and give caller address of his portion in R1 and chain the 
remainder to the appropriate subpool size. Return to caller. 

DMKFRE, CLEARSAV 

If no block can be found to honor user request, call - 

DMKPTRFR 

Fetch a page from the dynamic paging area. Chain it to the free 
storage chain. Processing then continues. See entry DMKFRE, 
FREESUB. 
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DMKFRBRS 

Entry to return all subpool blocks to the free storage chain per the 
SOBTABLE reference, as each subpool block is released, its address 
and length are placed in R1 and R2 respectively. Branch and link to 
FRET05 to return the block to the free storage chain (DHKFRELS) . 
Repeat action through all subpools. Return to caller. 

DMKFRET 

Entry to restore block to subpool or free storage. Per RO and R1 
(number of doublewords to be released and and address of the first 
double word, respectively) , the subpool sized block is returned to 
the appropriate subpool. Update the pointer in the SOBTABLE. 

DMKFRE, FRET 21 

If subpool size block being returned is vithin the dynamic paging 
area, process as a block of more than 30 doublewords. 

DMKFRE, FRET 20 

Blocks larger than 30 doublewords to be returned are merged into the 
free storage chain indicated by DMKFRELs. 

DMKPTRFT 

Restore page to dynamic page area; if a complete page is alloted, 
blocks belonging to the dynamic paging area can be built. 

DMKFRE, FRET03 

Return a block of storage to free storage chain by merging into the 
chain storage addresses in an ascending order of sequence. Return to 
caller. 



CP INITIALIZATION AND TERMINATION PROCEDORES 
Loading the Nucleus 

DMKCKPT 

Initial entry point to load the system after loading the first 

module, DMKCKP, from the system residence volume. Check CPID in PSA 

for startup method. 
DMKSAVRS 

For CPID equal to not warm or not CPCP, insert COLD and load the 

nucleus. Then branch to DMKCPINT, to perform CP initialization. 
DMKCKP, NOTERM 

ON CPID equal to WARM or CPCP, halt and drain all I/O devices and 

remember enabled terminals. 
DMKCKP, NEXTCH 

DMKRSPC? to validate warm start cylinder. 
DMKCKP. CLOCK OK 

Save accounting data, log message, SDFBLOKs, and enabled terminals 

and lines on checkpoint cylinders. 
DMKCKP. CHK05 

Save spool records allocation and spool hold queue blocks on 

checkpoint cylinder. 
DMKCKP. SHUTS YS 

If normal shutdown indicated, issue message to system operator and 

load disabled wait state code X f 008'. 
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System Initialization 

DMKCPINI 

Entry point to perform system initialization. 
DMKCPI, KEYL OOP 

Determine real storage size, initialize CQRTABLE, allocate free 

storage and initialize system paging tables. 
DMKCPI, CPIHIP 

Check via HIO for online and ready status of all DHKHIO generated 

devices. 
DMKCPI, CPISTCAW 

Read volume labels and match to RDEVBLOK, RDEVSER. 
DMKCIP, DMP ALLOC 

Allocate dump file to system device. 
DMKCPI, ALOCLP 

Build allocation block for CP-0¥ned devices. 
DMKCPI MICTEST 

Test for virtual machine assist feature availability If available, 

build MICBLOK and link to VMMICRO. 
DMKCPI, NPSWS 

Locate an available primary or alternate system console (PSA values). 
DMKCPI, NOTCHNG 

Build user directory page list per DMKSYSUD. 
DMKLOGOP 

Log on the system operator. 
DMKCPI, STARTS YS 

Force nonnucleus modules to DASD page. 
DMKIOEFL 

Initialize error recording cylinders. 
DMKHLDR 

Auto load 3704/3705; if appropriate. 
DMKAPIPR 

Initialize PSAs for each processor. Called only if the attached 

processor is available. 
DMKCLKCK 

Synchronize the TOD clocks if necessary. Called only if the attached 

processor is available. 
DMKCPYAE 

Enable 270X lines, if appropriate. 
DMKCPI, CPIDSP1 

Log on the AUTGLOG user. 
DMKPTRDL 

Unlock CPI as initialization is complete. 
DMKDSPCH 

Await interrupts. 



Warm Start 

DMKHRMST 

Entry from DMKCPI initialization. Check R2=01; if it is, go to 

DMKHRN, WARMCLR for cold start. Check warm start cylinder for 8 byte 

X»FF«s identifier. 
DMKWRH* ENABLERT 

If enable records on, warm start cylinder, enable appropriate 

RDEVBLOKs. 
DMKWRH, EN 370 S 

If warm start record indicates, set flag for auto load of the named 

NCP program. 
DMKWRM, ENR3270 

Enable binary synchronous lines by clearing NICBLOK offline flag (if 

appropriate) . 

CP Method of Operation and Program Organization 1-209 



DMKWRM, ACNTRT 

Build ACNTBLOK, load it with van start cylinder data and chain it. 
DMKWRM, WARMLOG 

Build buffer and load it with the saved log message. 
DMKWRM, HARMS PL 

Build SPFBLOKs and fill with appropriate printer, punch, and reader 

spool data. 
DMKWRM, WAR HOLD 

Build SHQBLOK and move hold queue record data to the new block and 

chain it to the hold queue chain. 
DMKWRM, WARMCLR 

Clear 8 bytes of record 1 on the warm start cylinder. Check CPID 

again. 
DMKCKSWM 

For CPID=CKPT or FORCE, reconstruct spool checkpoint records. 
DMKCKSIN 

For CPID=NOT CKPT or NOTFORCE, initialize the checkpoint cylinders. 
DMKCKSPL 

Files in the systems spool hold queue are added to the checkpoint 

cylinder. 
DMKWRM , GET DISK 

Read in the remainder of warm start data. 



Normal Shutdown 

DMKCPSSH 

Entry point results from invoking CP SHUTDOWU command. Close active 

spool files for callers or operator console. 
DMKCPS, DASDCH 

Via RDEVBLOK, locate and record DASD statistical data. 
DMKCPS, DAS DC HI 

Put CPCP into CPID to denote shutdown. 
DMKDMPRS 

Set up CAW, CCWs and load CP via IPL from system residence device. 
DMKCKPT 

Save spooling and accounting data. 
DMKMOHSH 

Stop monitor tape activity. 
DMKCPI SHUTSYS 

Sense shutdown flag, issue DMKCPI961W, enter disabled wait state code 

X»006». 

Dump the System 

DMKDMPDK 

Entry occurs via ABEND000 condition or by pressing system console 

RESTART button. Save PSA values. Determine if dump is full or just 

CP portion. 
DMKDMP, DMPMSG 

Format and issue abend message to operator and transfer to DMKDMP and 

DMPDASD. 
DMKDMP, DMPDASD 

Write out a defined amount of storage or all storage to selected 

DASD. 
DMKDMP, DSKENJ) 

Place sending record number and the system file number in the dump 

file SFBLOK. 
DHKDMP, RECSRCH 

Chain dump file RECBLOKs to RDEVBLOK, and link dump file SFBLOK onto 

the system reader chain. 
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DMKDSP RESTART 

Restart the system on warm start indication. 
DMKDMP. DMPTAPE 

Dump CP storage or all storage to the selected tape drive per 

specified tape parameters. 
DMKDMP RESTART 

Restart the system if warm start is indicated. 
DMKDMP, DMPPRT 

Dump CP storage or all storage to the selected printer. 
DMKDMS RESTART 

Restart the system if warm start is indicated. 

VIRTUAL MACHINE INITIALIZATION AND TERMINATION 

Attaching a Virtual Machine to the System 

DMKCNSIN 

Entered via interruption from a console or terminal (not displays) 

device. If appropriate, determine and store device type in the 

RDEVBLOK. Write the VM/370 online message. Sets up to receive 

attention interruption. 
DMKBLDVM 

On attention interruption, build skeleton VMBLOK for LOGONxxx. 
DMKCFMBK 

Send read CCWs to the terminal for LOGON or DIAL response. 
DMKTRMID 

On response determine translate tables to be used. 
DMKCFM BK 

Validate command and transfer to DMKLOGON. 
DMKLOGON 

LOGON command execution. 
DMKDIAL 

Dial access linkage to multiaccess system. 
DMKUDR 

Via user directory access, validate user logon eligibility. On 

acceptance of eligibility, that is the successful completion of 

logon, build and allocate control blocks and linkages for the user's 

virtual machine. 

IPL the Virtual Machine 

DMKCFGIP 

For the IPL of a named saved system, the name is verified and 
resources are checked for availability. Virtual storage is set up 
with the saved system via SWAPTABLE, SEGTABLE, SHRTABLE updates. For 
the IPL of device address, the IPL simulator is loaded in the user's 
storage. 

DMKVMIPL 

User's page 0, set console address, IPL device address, VMBLOK flags 
IPL device type and class and user CAN. Read in 2*» bytes from the 
CTCA, reader, DASD or tape unit into the user's virtual location 
zero. The CCW pointer is now set to the IPLCCW at virtual location 
X*8' and the program is loaded. 

DMKVMI. IPL DONE 

For IPL STOP, the virtual machine is placed in console function mode 
to allow change to nucleus name and apparent storage size before 
continuation. 

DMKVMI, LOADNOW 

IPL address is inserted in X , 02' if BC mode, or X'BA', if EC mode. 
The user's CAW and registers are restored and control is given to the 
user by loading the current PSW at virtual location 0. 
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f irtua l Machine Termi nation 

DMKDSOLG 

Entry is the result of user invoking LOGOFF. Set flags in VHBLOK 

indicating logout operation. 
DMKUSO, US006 

Retain line communication, if HOLD operand specified. 
DMKUSO, DS008 

Adjust return address to not run the user. 
DMKOSOFF 

Set VMBLOK flags. 
DMKTRCND 

Called to reset tracing. 
DMKPERT 

Called to reset tracing. 
DMKACOTM 

Accounting called to compute the connect time for the LOGOFF message. 
DMKQCNWT 

Write the message to the user. 
DMKSCHDL 

Called to alter user dispatch status. 
DMKCFPRR. DMKCSPO 

Reset the virtual machine. 
DMKVMCAN 

Release or return VMCBLOKs if VMCF is active. 
DMKVAT BC 

Release shadow tables (if any) . 
DMKSCHRT 

Dequeue clock comparator request (if any) . 
DMKBLDRL 

Release segment tables, page and swap tables related to the user. 
DMKUSO, US094 

7ia DMKFRET return user VMBLOKs to free storage. 
DMKUSO, DS093 

For the system operator, clear and reinitialize the VMBLOK. 
DMKFRET 

Return all other virtual machine control blocks to free storage. 
MEACOFF 

Punch an accounting card for the user. 
DMKUSO, US098 

Free LOGOFF message area. 'Exit to do free storage maintenance. Exit 

to DMKCFM or DMKDSPCH. 
DMKUSOFL 

Entry is the result of the invoked FORCE command. 
DMKSCHAU 

Locate userid VMBLOK. 
DMKUSOFL 

Set VMKILL in VMBLOK, build CPEXBLOK and stack it for dispatcher. 
DMKDSPCH 

Upon CPEXBLOK execution, process as at LOGOFF entry DMKUSOFF. 
DMKUSODS 

Entry from an invoked CP DISCONN command. Set disconnected VMDISCK 

in VMOSTAT. 
DMKQCNWT 

Send disconnect message to user. 
DMKUSODS 

Increment return address to DMKCFM by 4 to prevent a return read to 

the use^s terminal. Clear VMTERM field to indicate the user 

terminal is disconnected. 
DMKO.CNWT 

Send message to system operator informing him of user disconnect 

status. Exit to DMKCFM. 



1-212 IBM VM/370 System Logic and Problem Determination — Volume 1 



CONSOLE FUNCTION (CP COMMAND) PROCESSING 

DMKCFMBK 

Entry used when the ATTENTION key (or equivalent) is pressed once or 
twice (according to the VM or CP status) to allow the user to direct 
a line of input data for CP command processing. Set VMFCWAIT and 
7MCF bits in VMBLOK indicating wait state and console function mode. 

DMKFREE 

Builds an 18-doubleword CONBOF buffer for the read operation. 

DMKSCNFD 

Matches the 8-byte command name against the table of matching command 
names, the truncations of command names, and the allowable 
abbreviations, starting at COMNBEGO. The format of the table entry 
is: 

Field N umber of Bytes 

Command name 8 
Class mask 2 

Abbreviation count 2 
Routine address 4 

DMKCFM, CONFFIND 

After a command match has been made, the privilege class of the 

command is matched with the user's privilege class, VMCLEVEL in the 

VMBLOK. 
D MKCF M, CON FC ALL 

The last four bytes of a command contain the address of the routine 

that processes the command. 

See "CP Diagnostic Aids" for a list of all CP commands and the 
associated processing modules. 



DMKQCNRD 

Read in the terminal input command line. 
DMKCFM AT 

On NOLL data and ATTN key indication, post attention interrupt 

pending in VDEVBLOK, VCDBLOK and VCHBLOK. Return to run the virtual 

machine. 
DMKCFHRQ 

On receipt of CP commands ATTN or REQUEST, process the same as 

previous entry, DMKCFMAT. 
DMKCFM 

On receipt of * (asterisk) return to DMKCFMBK to set up another read. 

If console spooling is enabled, all console input and output 

including comments are spooled for printer output. 
DMKCFMBE 

On receipt of BEGIN, simulate the start button on the virtual machine 
(If optional address is supplied with BEGIN command the supplied 

address is substituted for the location counter address) . 
DMKCVTHB 

Convert this address to binary notation. 
DMKCFMSL 

On receipt of the SLEEP command or SLEEP with time value (simulation 

of virtual machine stop button depression) the VMBLOKs VMSLEEP bit is 

set. The terminal console keyboard is now inactive until the user 

hits an ATTENTION key or the SLEEP command times out. 
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DISPATCHING AND SCHEDDLING 

last Reflection for the Dispatched Vir tual Machine 

DMKDSPA 

Entry for fast reflection activity. If the user is no longer 
runnable, or if the system is extending, the fast reflect path is not 
continued and processing continues at the main dispatcher entry 
point. 

DMKDSP, OPVIRT 

If the user is running virtual timers, update and test the user's 
virtual timers. 

DMKDSPA1 

If the user is still dispatchable, build the new RONPSW from either 
IOOPSW or PROPSW and redispatch the virtual machine. 

PSW Validation 

DMKDSPB 

Entry to dispatcher when the user's PSW has been external to DMKDSP. 
DMKDSP, CKPSW 

Verify the PSW change. 
DMKDSP, CKPEND 

Onstack any pending interrupts for the user (if enabled) . 



MAIN Dispatch E ntry 

DMKDSPCH 

Normal dispatch entry after each interrupt handler has finished 
processing, and after each CPEXBLOK, I/O reguest and external 
interrupt has been serviced. 

DMKDSP, RUNTIME 

If CPSTATOS indicates return from running a user (CPRDN on) , first 
ensure that supervisor time is being charged to RDNOSER. Check the 
user for time-slice end or gueue-slice end, store the time remaining 
in the time-slice, and update processor problem state time. Also 
update virtual timers if running. 

DMKDSP, WAITIME 

If CPSTATOS indicates return from wait (CPWAIT on) , first ensure that 
supervisor time is being charged to the system. Determine the type of 
wait (I/O wait, page wait, or idle wait) and save the appropriate new 
wait time value. 

DMKDSP, ONSTACK 

For nonrunnable virtual machine, go to label CHKILL in DMKDSP. 

DMKDSP, ONSTACK 

For runnable user, check pending interruptions for the following: 

• DMKDSP, CKPEND 

Per interruption (VMPERPND) 
Pseudo page faults (VMPGPND) 
External interruptions (VMPXINT) 

• DMKDSP, ONSTIO 

I/O interruptions (VMIOINT) 

• DMKDSP. STORECSW 

I/O interruptions are reflected by swapping user PSWs and storing 
the unit address and status in low storage. 

• DMKDSP, CLEAR™* 

Clear the pending bits in the VMBLOK. 
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DMKDSP, CKPSW 

Validate the PSW. 

• DMKVATBC 

For virtual machine leaving EC mode, clean up the shadow tables. 

• DMKVATMD 

For virtual machine in BC mode and entering translate mode, 
initialize shadow tables. 
DMKDSP, DSPERMSG 

For PSW invalid, send error message to virtual machine, and place 
user in CP mode. If disconnected and invalid PSW, log off user. 
DMKDSP, DISPATCH 

Complete processing for current user. Call DMKSCHDL if necessary to 
alter user's dispatching priority. 



Selecting the Next Unit of Work 

DMKDSP, CKCPSTAK 

Process a stacked request. First check the stack of lOBLOKs and 
TRQBLOKs. If system is not extending, unstack normally. Otherwise, 
only unstack paging or PCI lOBLOKs. 

DMKDSP, WINDOW 

Before examining the stack of CPEXBLOKs, open a window for interrupts 
if the system is not extending. 

DMKDSP, CKCPREQ 

Check the stack of CPEXBLOKs. If the system is extending, only 
unstack those blocks that will allow the extend to complete. If the 
system is not extending, unstack normally. If a CPEXBLOK for the 
other processor is encountered, give up the system lock and signal 
the other processor. 

DMKDSP, CK USERS 

If no stacked requests can be unstacked, select a user for 
dispatching. If the system is locked for running users (such as 
during extend), load a wait state. Scan the run list for a 
dispatchable candidate. If none is found, load a wait state. If 
there is also a runnable user for the other processor, signal the 
other processor. If a runnable user is found, set up to dispatch this 
user. 



Scheduling Users for Execution 

DMKSCHDL 

Main entry to maintain queues of runnable and eligible users and to 

alter the user's dispatching status and (when necessary) his 

dispatching priority. 
DMKSCH, CKRSTAT 

If the user is now not runnable, but was runnable before, mark the 

user as not runnable. If the user is in the eligible list, drop him 

from the list. If the user is in an idle wait state, drop him from 

the queue. 
DMKSCH, CKRUN 

If the user is now runnable, mark him as runnable. If the user was 

not in Q before, add him to the eligible list. 
DMKSCH, CKWAITNG 

Look through the eligible list for runnable users to add to active 

queues. 
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Other Scheduler Function 



DMKSCHST 

Set a clock comparator interrupt request. 
DMKSCHRT 

Reset a clock comparator interrupt request. 
DMKSCHMD 

Set up a request block for midnight date change 
DMKSCH80 

Process a real interrupt timer request. 
DMKSCHCP 

Process a real CPU timer interrupt. 



SPOOLING VIRTUAL DEVICE TO REAL DEVICE 
P roces sing Virtual Output Files 

DMKVSPEX 

Entry from DHKVIO to initiate SIO on a spooling device that is 

available (not busy and no interruptions pending) . 
DMKVSP, OPEN 

Determine if output device needs to be opened. 
DMKSPLOV 

If yes, build message control blocks: SFBLOK and VSPCTLBLOK. 
DMKPGTVG 

Obtain a virtual buffer; the address is stored in VSPVAGE. 
DMKPGTSG 

Obtain a DASD page; the address is stored in VSPDPAGE. 
DMKVSP, BUILDCTL 

Assign a spoolid and the other user, record, and device values plus 

DMKCVTDT. 
DHKCVTDT 

Assigns the time stamp and date and stores it in SFBLOK. 
DMKVSP, PRTCONT 

Generate TAG record at the start of the spool data buffer. 
DMKVSP, CCWOK 

After CCW validity check, data and CCWs (if appropriate) are moved to 

the work buffer. Trailing blanks are truncated and when the buffer 

is full, it is written out to the DASD slot. 
DMKVSPVP 

On console spooling, the following occurs: 

1. Skip to channel 1 every 60 lines. 

2. Write out the system console, spool file buffer every 16 lines. 

3. Place the system console in a pseudo closed state for checkpoint 
recovery in the event of system failure. 

DMKVSP, LASTCCW 

When all CCWs are processed, post interruption pending to the 
VDEVBLOK, VDEVCSW and return control to the user. 



Cl osing Virtual Output File s 

DMKVSFCO 

Entry via CP CLOSE command, if device busy, defer close operation by 

building CPEXBLOK, stack it and exit to dispatcher. 
DMKVSP, PRTEOF 

On device not busy, write final buffer page to DASD storage. 
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DMKSPLCV 

Queue closed virtual printer or punch spool file to the real spool 

output device, or transfer the file to another user's virtual reader. 

Also update the SFBLOK with number of copies printed/punched, 

distribution code, hold status, and file owner ID. If VSPXBLOK with 

TAG data exists for the spool device, copy the TAG data to the TAG 

record in the first spool file data buffer. 
DMKSPL, TXTXFR 

If a "spooled to" file, queue to the end of the reader file chain. 

Otherwise, chain the SFBLOK to the designated real spool printer or 

punch. 
DMKCKSPL 

Checkpoint the new spool file block. 
DMKSPL, SET P END 

For a "spooled to" file find a virtual reader with 

and in the ready state with no active file. 



the proper class 
and no pending 
Then build an IOBLOK with IOBIRA of DMKVIOIN. 



interrupts 
DMKSTK IO 

Stack the IOBLOK. 
DMKSPL, SET P END 

Exit to DMKVSP. 
DMKSPL , TSTHOLD 

For not "spooled to" files and 

printer or punch with the proper 

IOBIRA Of DMKRSPEX. 
DMKSTKIO 

Stack the IOBLOK. 
PMKJIPL, TSTHOLD 

Exit to DMKVSP. 



not in user or system hold, find 
class. Then build an IOBLOK with 



Processing Virtual Input Files 



DMKVSP, OP EN RPR 

Entry to open a spool input file. If VDEVSPL=0 the file needs to be 
opened. Build VSPLCTL block and a work buffer. Search the system 
reader file chain per PSA linkage ARSPRD for a file with appropriate 
user and class. 

DMKVSP, SET FLAG 

On file-found condition, place first DASD page address in VSPLCTL, 
VSPDPAGE. Obtain a virtual buffer and retain its address in the 
VSPLCTL block. 

DMKVSP, READER 

Check the CCHs for validity, move and expand the data back to its 
original size and the data is moved from the work buffer to user's 
virtual storage. 

DMKVSP , RDR COUNT 

On EOF, set SFBEOF bit in SFBLOK and return to caller. 



Closing Vir tual I npu t Files 



DMKVSPCR 

For CLOSE operation requested via console coimand and the device is 

busy, initiate a delayed close by constructing and stacking the 

CPEXBLOK for the CLOSE. 
DMKVSP , RDR EOF 

For normal end of file and VDEVSFLG indicates continuous read. 
DMKVSP, OPENCONT 

Locate the next file and continue reading. 



CP Method of Operation and Program Organization 



1-217 



DMKVSP, LAST FILE 

For last file, post end status in RDEVBLOK. 
DMKVSP, FILECLR 

For HOLD status file (VDEVSFLG=VDEVHOLD) , call DMKCKSPL. 
DMKCKSPL 

Checkpoints the file. 
DMKVSP, FILECLR 

Onchain the file (except hold files) from the reader queue and call 

DMKSPLDL. 
DMKSPLDL 

Delete the file. 
DMKVSP, DVICECLR 

To clear the device, call DMKRPAGT. 
DMKRPAGT 

Releases the storage page. 
DMKPGTVR 

Releases the virtual buffer. 
DMKFRET 

Releases storage for the work buffer and VSPLCTL block. 

SPOOLING TO THE REAL PRINTER/PDNCH OOTPDT DEVICE 

DMKRSPEX 

Entry from the dispatcher when an IOBLOK is unstacked with and 

interrupted for spooling unit record device. IOBRADD points to the 

RDEVBLOK RDEVTYPC input or output class. 
DMKRSP, RSPLOOT 

If RDEVSPOL indicates an available spool device (not active), 
DMKFREE 

Get storage for a work buffer and build a RSPLCTL block and link it 

to RDEVBLOK. 
DMKRSP, PRNXTFIL 

Search printer and punch SFBLOK chains for corresponding device and 

class. On a found condition, unchain the block, put its address in 
| RSPSFBLK. The FLASH name specified in the SPOOL command, if FLASH is 
I specified, must match the flash overlay name for a 3800 printer. 

DMKSEPSP 
I If called, provides separators for output pages or cards. 
I DMKTCgET 

I If the device is a 3800 printer, call this module to set it up. 
DMKRSP , PROCESS 1 

Bring first spool data DASD page to the work buffer and convert CCW 

addresses to real device addresses. 
DMKIQS0.R 

Start the spool device. 
DMKRSP, PRNXTPAG 

Repeat the process until done. 
DMKRSP. REPEAT 

Reprocess and reaccess the buffer, if multiple copies are specified. 
DMKCKSPL 

Checkpoint records the change to COPY count. 
DMKSPLDL 
I Delete the file on completion (unless HOLD specified) . If the device 
I is a 3800 printer, check for delayed purge. 
DMKRSP, PRNXTIIL 

Locate the next spool file to process. 
DMKRSP. PRTIDLE 

Processing for the device is complete as there are no more SFBLOK, 

for this device or the device was drained. 
DMKFRET 

Release work area and completed IOBLOK storage. 
DMKDSPCH 

Exit to the dispatcher. 
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SPOOLING TO THE REAL INPUT DEVICE 

DMKSPLOR 

Assume there is no active file being processed on the real input file 

reader. The spooling operator has issued the START command to the 

device to "open" the reader. 
DMKSPL, BUILD CTL 

Build RSPLCTL and SFBLOK. 
DMKPGTVG 

Get virtual buffer and place its address in RSPVPAGE. 
DMKPGTSG 

Get DASD buffer and place its address in SFB START and RSPDPAGE, linke 

together by pointers. 
DMKIOSQR 

Start the reader. 
DMKDSPCH 

Await the interruption. 
DMKRSP, RDERGETID 

Check that the first card in the buffer is the userid header. If so, 

proceed. 
DBKRSP RPR CAR PS 

Preload the buffer with CCWs. 
D MKIOS QR 

Issue the SIO (SIO's of 42 cards per buffer load). 
DMKRSP, RPR SIO 

Write the buffer to the DASD slot. Repeat until EOF detected. 
DMKSPLCR 

Close the file on EOF. Queue the file on reader spool chains. 
DMKCKSPL 

Add the spool reader file block to the checkpoint cylinder data. 
DMKSPL . RDRPEND 

If the file owner is logged on, and his virtual reader is available, 

an IOBLOK is constructed with device end pending - 
DMKSTKIO 

Stacks it. 
DMKRSP. RDREXIT4 

Release storage for virtual buffer, RSPLCTL and the SFBLOK. 
DMKDSPCH 

Exit to the dispatcher. 



SPOOL FILE DELETION 

DMKPLDL 

With R7 not equal to zero, place the specified SFBLOK on the delete 

chain anchored to DMKRSPDL. 
DMKCKSPL 

Delete the SFBLOK from checkpoint cylinder data. 
DMKSPLDL 

Assume the delete routine is not running, build a CPEXBLOK to call 

DMKSPLDR. 
DMKSPLDR 

Sets the DELSW=X , 80» (delete routine active) . 
DMKSTKCP 

Stacks it and exits to caller. 
DMKSPLDR 

On unstacking the CPEXBLOK, if the SFBLOK is a system dump file, 

calls DMKDRDDD. 
DMKDRDDD 

Deallocates DASD buffers. 
DMKSPL. NEXT SFB 

For complete allocation chains of RECBLOKS, call DMKPGTSR 
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DMKPGTSR 

deallocate DASD buffer and return to storage held by the dummy 

HECBLOKs. 
DMKSPL, DEL ST ART 

For incomplete allocation RECBLOK chains, deallocate by calling 

DMKPGTSD. 
DMKPGTSD 

Deallocates a page at a time via SFBSTART and the IOBLOK until the 

last page is reached. 
DMKFRFT 

Delete the SFBLOK, then go to DHKSPL and NEXTSFB. 
DMKSPL, NEXTSFB 

If the delete gueue is not empty, process the next SFBLOK an 

identical manner. Continue until all SFBLOK deletions are complete 

then call DMKFRET. 
DMKFRET 

Delete the IOBLOK. 
DMKDSPCH 

Exit to the dispatcher. 



RECOVERY MANAGEMENT SUPPORT OPERATION 
Establ ishin g the Err or Recording Base 

DMKIOEFL 

Entry from CP initialization module to set up pointers to VM/370 

error recording cylinders. 
DMKI0GF1 

The STIDP instruction stores processor version and model in CPDID of 

PSA. 
DMKIOG. IS SUE INS 

Check attached channels. If standalone channel on the 165 or 168, 

the address of the logout routines is stored in the DMKCCH module. 
DMKIOG. CHANGE ID 

Set up pointers for machine check and channel check record area and 

extended logout areas. 
DMKIOG. IOGMCHIN 

Obtain storage for machine check record, extended logout area, and 

CPEXBLOK. The HCHAREA is also initialized. 
DMKIOG. PASTDAYE 

Determine the 90X-full and 100%-full capacity of designated error 

recording cylinders and store the amount in DMKIOEMX and DMKIOENI 

respectively. 
DMKIOG. FINDREC 

Check first record of the error recording cylinders for proper 

format. If invalid, reformat. If valid but clear, store pointer value 

in PSA as the first available slot for error record. If valid but 

used, search for first unused slot and store its value in PSA. 
DMKIOGFR 

If on a 3031, 3032, or 3033 processor, read frames from the SRF 

(service record file) device, and write them to the beginning of the 

error recording cylinders with unique record types. 
DMKIOG, CYLFDLL 

When error recording area is full, inform the operator, and continue. 
DMKIOEFL 

Turn off the recording in progress switch and exit to caller. 
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Proce ss the Machine Check Interruption 

DMKMCHIN 

Entry via the machine check PSW upon detection of an unrecoverable 
and nonfatal processor or storage error. Disable soft machine 
recording store logout area on the machine check and channel check 
recording cylinders. The system is enabled for hard machine checks 
with a pointer to the termination routine. DMKMCH, ENHARD for virtual 
user store status in VMBLOK. DMKMCH, MCHSYSIL for system damage 
timing facility or uncorrectable retry, multibit storage error post 
system operator message, flag system as terminated. Place wait state 
code, if first hard error, record it. If the fault occurred in 
problem state, terminate the active virtual machine. 

DMKMCH, SOFTSTG 

For corrected ECC or processor retry, update soft error count and 
record the error and dispatch the virtual machine. 

DMKMCH, MCHSKIP 

For multibit storage error in problem mode, exercise storage location 
to clear up or flag as unavailable (permanent error) . 

DMKMCH. MCHCHANG 

On an altered page condition, the virtual machine is reset, 
otherwise, the error is recorded and the virtual machine is 
redispatched. 

DMKMCH SPFTEST 

Storage key failure. Exercise the 2K page key. If CP area and solid 
error condition process as DMKMCH, MCHSYSIL, intermittent, restore 
the key and go to the dispatcher. If key failure and in virtual 
machine area if permanent error, mark page as unavailable, terminate 
the user. If intermittent condition refresh the key and dispatch the 
virtual machine. 

DMKMCH, VIRTERM 

On conditions that cause the termination or reset. The error is 
recorded, and both the user and the operator receive status messages. 
Per the termination flag, VMBLOK, the user is logged off and control 
returns to the dispatcher or is reset via DMKCFPRR. 

DMKCFPRR 

Virtual storage is released, the virtual machine is flagged 
dispatchable and placed in console function mode. 

DMKMCH, TERM 

On a hard machine check while handling a machine check, the machine 
check new PSW is loaded with a wait state PSW and the current PSW is 
enabled for hard machine checks. 

DMKMCH. MCHTERM2 

Locate the system or the user's VMBLOK. 

DMKMCH. OPCOM 

Call DMKMCTPT if system is running in attached processor mode. 

DMKMCH. MCHWAIT 

Load disabled wait state for uniprocessor system. 

DMKMCTPT 

Complete processor termination for attached processor system. If the 
error is on the attached processor and it is in problem state, signal 
for automatic processor recovery and stop the attached processor. 

DMKMCT, SWITCH 

Make sure processing is on the main processor and set up the 
appropriate wait state code. 

DMKMCT, OPCOM 

Issue a message to the operator and load a disabled wait state for 
the attached processor system. 

DMKMCTPR 

Perform automatic processor recovery function. Allow system to 
convert to uniprocessor mode by calling DMKCPDDP. 
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DMKMCT, PR EX IT 

Terminate the virtual machine if it is in control. Reset the main 
processor timer. Clear all lock words and return to the dispatcher. 



P roces s the Ch annel Check Interruption 

DMKCCHIS 

Entry via DMKIOS via CSW channel error 
DMKFREE 

Obtain storage and build a CCHREC block and if IOBLOK and RDEVBLOK 

exist, build an IOERBLOK. 
DMKCCH, CCHIOERL 

Store the CCHREC address, its length, and the CSW in the IOERBLOK. 
DMKCCH, CCHDEPND 

Call appropriate channel error analysis module. Analyze channel 

logout data for validity. 
DMKCCH, SCNEND 

Record the error on the error recording cylinder, if appropriate. 
DMKCCH, CPTERM 

Terminate CP if the PSA's terminate flag is set. 
DMKCCH, CCHWA IT 

Set up X'OF 1 wait state code and call DMKMCHST to terminate the 

system. 
DMKMCHST 

If the system is running in attached processor mode, call DHKMCTST. 
DMKMCH, CALLOPR 

Issue an error message to the operator. 
DMKMC H, MCHWAIT 

Load a disabled wait state for a uniprocessor system. 
DMTMCTST 

Make sure system is running on the main processor. 
DMKMCT, CALLOPR 

Issue an error message to the operator. 
DMKMCT, MFAWAIT 

Load a disabled wait state for attached processor system. 
DMKCCH, SCNEND 

Unless termination is established, return to DMKIOS for recovery. 



Recording the Errors of the Virtual User Via SVC 76 

DMKVER D 

Entry via DMSPSA as a result of SVC 76 detection. Check parameters 

passed in RO and R1. 
DMKFREE 

Obtain storage for a record buffer for the user error record. 
DMKVER, BDFFOL 

Using valid record type (from the buffer) branch to an appropriate 

routine to format that particular record type. 
D MKVE R, VER30 

Using RDEVBLOK, VDEVBLOK and VMBLOK, convert virtual data to real 

values and place in record. 
DMKIOERV 

Record the error. 
DMKDSPCH 

Exit to dispatcher. 
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USER DIRECTORY ROUTINES 

DMKUDRFU 

Entry after CP detected LOGON command. DMKSYSPL points to the 

directory. Determine length of userid, if valid call DMKLOCKQ. 
DMKLOCKO, 

Lock the directory in storage. 
DMKUDR, NXTPAGE 

Bring in each directory page and return each page (and clear the 

buffer) until a UDIRBLOK match occurs or directory's last page is 

detected. 
DMKUDR, FINDUSER 

On userid found, move UDIRBLOK to caller's area. 
DMKLOCKQ 

Unlock the directory in storage. 

unrvui/n , j ja xi^v.u 

Return to caller. 
DMKUDRFD 

Entry from calling routine to find the addressed (cuu) device 

UDEVBLOK in users directory and move it to the caller. Via UMACBLOK 

locate the UDEVBLOKs. 
DMKUDR, FIN DDE V 

Check to see if the user device address is the same as in the 

UDEVBLOK. Search the chain until match or end of chain occurs. 
DMKUDR, DEVFOUND 

For found condition, post condition code zero in user's VMPSW. 
DMKUDRRD 

Entry from calling routine to read the UDEVBLOK addressed into the 

caller's buffer. Using the DASD and the user displacement from the 

UMACBLOK, bring in the buffer page to storage. Determine if the 

virtual directory page address (UDBFVADD) exists in the user 

directory buffer blocks. If not call- 
DMKPGTVG 

and get a virtual page. 
DMKRPAGT 

For DASD address does not match the UMACBLOK, point to the DASD page 

and bring in the virtual buffer page. Move UDEVBLOK into callers area 

and set cc=0 in VMPSW. Return to caller. 
DMKUDRRV 

Entry to return a virtual page used as a buffer. Determine if 

UDBFBLOK contains a virtual buffer page pointer (UDBFVADD) . If not, 

exit with cc=1 set in the VMPSW. If a buffer exists, check to see if 

it is resident; if it is, clear it to zeros. 
DMKPAGT 

Return the real page to the system. 
DMKRGTVR 

Return the virtual page to the system. 
DMKUDRRV 

Set cc=0 and return to caller. 
DMKUDR B V 

Entry from DMKDIRCT or DMKCPINT to build page buffers for each 

UDIRBLOK. 
DMKFREE 

Get storage for the virtual buffer page list. 
DMKUDR, GET VP AGE 

Call DMKPGTVG and DMKRPAGT to get the virtual and real buffer. Save 

the virtual buffer address in the page list. 
DMKUDR , FRETLIST 

Encountered I/O error, free the virtual buffer page list, post fatal 

message, set cc=3 and return to caller. 
DMKUDR, ENDLIST 

Swap the new virtual buffer page list with the old list. Anchor the 

new list to DMKSYSPL. 
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DMKODR, FRETLIST 

If there was a previous buffer page list, free it. Save the start of 
the user directory pointer in DMKSYSUD, and return to caller with a 
cc=0 in the VMPSW. 



SAVE THE 3704/3705 CONTROL PROGRAM IMAGE PROCESS 

DMFCS_NCP 

Entry from DMKHVC and DIAGNOSE code 50. Per the system VMBLOK, 

locate the DMKRNTBL. The CCPARM virtual address is contained in R1 of 

the DIAGNOSE instruction. 
DMKSNC, NAMECHK 

Match via search CCPARM; CCPNAME with DMKRNTBL entries. 
DMKSNC. SIZECHK 

Verify DASD space requirements for 3704/37C5 control program and 

resource data. The volume required to save (NCPVOL) as indicated in 

the NCPTBL entry must be available and mounted on the system, on a CP 

owned and supported paging device. 
DMKSNC. SVRESDAT 

Save resource data on the NCPVOL device. CCPARM supplies the starting 

address and size parameters for this write operation. 
DMKSNC, SVNCPIM 

Save 370 4/3705 control program image on NCPVOL device. CCPARM also 

provides the parameters for this similar operation. 
DMKSNC. SAVEFINI 

Store cc=0 on no errors and return to caller. 



SPOOL FILE CHECKPOINT AND RECOVERY 
Initialization 

DMKCKS IN 

Entry from CP initializer, DMKCPI to initialize the checkpoint 

cylinders. Per DMKSYSCH, get a virtual page for the checkpoint 

cylinder and set up the device code in the system residence device. 

In addition, set up local data areas such as pages per cylinder and 

checkpoint cylinders. 
DMKCKS. CKSIN1 

Loop through each SFBLOK in the system and checkpoint it in a slot on 

the checkpoint cylinder. Then loop through each remaining slot and 

mark it empty. 
DMKCKS, CKSINS 

Place the map delimiter of the last non-empty slot in the map. 
DMKPTROL 

Unlock the map page. 
DMKCKS, CKSIN5 

Return to caller. 



Dynamic Checkpoint of Spool Files and Spool Devices 

DMKCKSPL 

Entry from any routine that adds, deletes, changes, the status of 
closed spool files. Lock the routine, or wait until it becomes 
unlocked. Bring the map page into storage and set up the device code 
of the system residence volume. 
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DMKCKS, LOOPS HQ 

If the change is applicable to a SHQBLOK (hold queue block) , make 

appropriate change on the checkpoint cylinder. 
DMKCKS , CKSPL 1 

If the change is applicable to a SFBLOK, either add, change, or 

delete it on the checkpoint cylinder. 
DM KCKS , CKSPL 5 

If the change affects a spooling device RDEVBLOK (for example, a 

START or DRAIH command issued) , mark the change on the checkpoint 

cylinder. 
DMKCKS, CKSEXIT 

Unlock the routine. Dnlock the page map and exit to caller. 



R econs truction of Checkpointed Closed Spool Files 

DMKCKSHM 

Entry via DMKCPI during VM/370 reinitialization process whenever the 

records for closed spool data need to be reconstructed. Get a virtual 

page for the map of the checkpoint cylinder and set up the device 

code of the system residence volume. In addition, set up local data 

areas. 
DMKCKS, CKSWM2B 

For slots having real device entries, set or reset the RDEVDISA and 

RDEVDRAN and move in the checkpointed device classes into RVDEVCLAS. 
DMKCKS, CKSWM2G 

For slots containing spool hold queue block, chain this to the SHQ 

chain. 
DMKCKS, CKSWM3 

Get storage for SFBLOK space and set flags depending upon its last 

checkpoint activity. 
DMKCKS, CKSWM4 

If the file SFBLOK was active, chain it to the appropriate printer, 

reader, or punch chain. 
DMKCKS, CKSWM5 

Allocate the DASD buffers of the spool file by reading each buffer to 

determine the next one and then allocate this page. 
DMKCKS , CKSWM6E 

For the dump spool file, the buffers are allocated sequentially from 

the beginning to the end. 
DMKCKS, CKSWM9 

Set up the map delimiter for the end of non-empty slot; then set up a 

new spool file identity (spoolid) higher than existing numbers. 

Return to DMKHRM. 



INTER-VIRTUAL MACHINE COMMUNICATION 

DMK7MC FC 

Entry from DMKHVC and the DIAGNOSE instruction code X*68'. Builds a 
VMCBLOK and initializes it with data from the user's parameter list, 
VMCPARM. The virtual address of VMCPARM is contained in bits 8-11 
(rx) of the DIAGNOSE instruction. 

DMKVMC . VMCFTBL 

Branch table to pass control to the appropriate subroutine based on 
the subfunction code in VMCPARM. 
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Subfunction 

Code Subroutines 

X»0000» VMCAUTH 

X'OOO'M VMCUAOTH 

X»0002« VMCSEND 

X'0003 1 VMCSENDR 

X'OOOlJ' VMCSENDX 

X»0005» VMCRECV 

X»0006« VMCCNCL 

X'OOO?* VMCREPLY 

X'OOOS' VMCQIES 

X'0009' VMCRESUM 

X'OOOA 1 VMCIDENT 

HMKVMC, VMCWAKOP 

Notifies a virtual machine of a pending VHCF communication by posting 
a special external interrupt X'^OOI' unless: 

• There is already a special external interrupt posted. 

• The virtual machine is running disabled for VHCF interrupts (PSW 
bit 7 and CRO bit 31) . 

DMKVMC, VMCXFER 

Transfers data from one virtual storage to another virtual storage. 
Errors occurring during data transfer are reflected to originating 
virtual machine via the data transfer return code in the final 
response interrupt message header. 

DMKVMCEX 

Called from DMKDSP to reflect an external interrupt message header to 
a virtual machine. If the VMCF subfunction is a SENDX, the SOURCE 
data is moved into the external interrupt buffer immediately 
following the message header. 

DMKZHCUA 

Called by DMKCFP when a virtual machine is logged off or reset. Uses 
the VMCOADTH subroutine (subfunction code X'OOOI 1 ) to dispose of 
existing VMCBLOKS before turning off virtual machine communication. 
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CP Directories 



This part contains the following directories: 

• CP Module Entry Point Directory 

• CP Module-to-Label Cross-Reference 

• CP Label-to-Module Cross-Reference 



CP Directories 1-227 



1-228 IBM VM/370 System Logic and Problem Determination — Volume 1 



CP Module Entry Point Directory 



Module 
Name 



Entry 
Points 



Attributes, Function 



DMKACO 



DHKALG 



DMKAPI 



DMKATS 



DMKBLD 



DMKBOX 



DMKACODV 
DMKACO FF 
DMKACON 

DMKACOPU 
DMKACOQU 

DMKACOTM 



DMKALGON 



DMKAPIPR 
DMKAPIAP 



DMKATSCF 



DMKBLDEC 

DMKBLDRL 
DMKBLDRT 

DMKBLDVM 



DMKBOXBX 
DMKBOXHR 



Pageable. 

Builds an account card buffer for a VDEVBLOK. 

Creates account card buffer for a VMBLOK. 

Provides additional accounting function at logon 

time (for installation use) . 

Punches queued up accounting cards. 

Queues up account card buffers for output on a 

real device. 

Creates a connect and usage time message for a 

user. 

Pageable. 

Handles the ADTOLOG command. 

Pageable. 

This module is entered from DMKCPI only if in 

attached processor mode. It is also entered from 

DMKCPU as part of the vary online processor 

function. 

Initializes the PSAs for each processor. 

Initializes the control registers for the 

attached processor. 

Pageable. 

Notifies the virtual machine that the command has 
replaced the shared system with a private copy of 
that shared system. The user continues to run 
without the shared copy of the named system. 
Called by the command processors via an SVC if 
the command execution is to change a shared page. 

Pageable. 

Allocates storage for a virtual ECBLOK and the 

two TRQBLOKs required for a virtual machine with 

the ECMODE option, and initializes these blocks. 

Releases real segment, page, and swap tables to 

free storage. 

Creates and initializes segment, page, and swap 

tables as a function of virtual storage size, 

which is part of the process of building a user's 

virtual machine. 

Creates and partially initializes a VHBLOK for a 

virtual machine, identified by its terminal real 

device block. 

Pageable. 

Provides the VM/370 or user logo (header) for 

printed output. 

Logo for initial screen display and header 

separator for printer spool files. 

Installation header reference. 
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CP Module Entry Point Directory 



Module 
Name 



DMKBSC 



DMKCCH 



DMKCCW 



Entry 
Points 



4— 



DMKBSCER 



DMKCCHIS 
DMKCCHNT 
DHKCCHRF 
DMKCCHRT 



DMKCCWB1 

through 

DMKCCHB8 

DMKCCWGN 

DMKCCWL1 

DMKCCWL5 
DMKCCH1 
DMKCCW2 
DMKCCWSB 

DMKCCWTC 

DMKCCWTR 



Attributes, Function 



Resident. 

Line error processing for remote 3270s on binary 
synchronous lines only. 

Examines the error condition resulting from a 
unit check or channel error that occurred while 
executing a CP-generated bisync line channel 
program. If the error is uncorrectable, DHKMSW is 
called to notify the operator, after return from 
DMKMSW, the original channel program is 
terminated and the fatal flag is set in the 
IOBLOK. If the error is correctable, the channel 
program is re-executed up to a maximum of seven 
retries. 



Resident. 

Operates with the I/O 

schedule a device-depe 

procedure when a channe 

check, or interface contr 

Entry from DMKIOS when 

when storing a CSW after 

Entry from DMKIOINT when 

on an I/O interrupt. 

Reflects channel check in 

machine. 

Entry from DMKIOE to all 

printed. 



interrupt handler to 
ndent error recovery 
1 data check, control 
ol check is detected, 
a channel check occurs 
a SIO. 
a channel check occurs 

formation to the virtual 

ow error messages to be 



Resident. 

CP assist TRANBRNG instruction (E60B) . 



CP assist CCWGENRL instruction (E60F) . 
CP assist TRANLOCK instruction (E609) . 
through 

CP assist DECCW1 instruction (E60C) . 

CP assist DECCWO instruction (E604) . 

Invokes an internal subroutine (CNTRLSOB) to 

obtain control bytes (seek data) . 

Searches previous (external) RCW chains and 

resolves the address of the RCW task if found. 

Takes the list of virtual CCWs associated with 

the user's SIO and translates it into a real CCW 

list. 

DMKCDB I I Pageable. 

Processes DISPLAY, DCP commands. 
DMKCDBDC | Executes the DISPLAY command to display real 

storage locations. 
DMKCDBDI | Displays virtual storage locations, storage keys, 

general registers, floating-point registers, PSW, 

CAH, and CSW at the terminal. 
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CP Module Entry Point Directory 



Module 
Name 



Entry 
Points 



+- 



Attributes, Function 



DMKCDM 



DMKCDS 



DMKCFC 



DMKCFD 



DMKCFG 



DMKCFH 



DMKCFM 



DMKCDMDM 
DMKCDMDD 
DMKCDMDM 

DMKCDMDD 



DMKCDSCP 
DMKCDSTO 



DMKCFCMD 
DMKCFCSL 
DMKCFCBE 
DMKCFCQU 
DMKCFCRQ 



DMKCFDAD 
DMKCFDLO 



DMKCFGCL 
DMKCFGII 
DMKCFGIP 



DMKCFHSV 



DMKCFMAT 



DMKCFMBK 



DMKCFMEN 



Pageable 

Processes DUMP and DMCP commands. 

Dumps real storage to spooled printer. 

Dumps virtual storage to the spooled printer. 

Dumps the contents of the specified real storage 

locations on the virtual printer spool file. 

Dumps the contents of the specified virtual 

storage locations, registers, PSW, and storage 

keys on the virtual printer spool file. 



Pageable. 

Processes 

Stores da 

Stores da 

Pageable. 

Gets the 

the CP co 

Processes 

Processes 

Processes 

Processes 

Presents 

machine 

interrupt 



STORE and STCP commands, 
ta into real storage (STCP command) . 
ta into virtual storage (STORE command) . 

address of the routine that processes 
nsole function that was requested. 

a CP console function. 

the SLEEP command. 

the BEGIN command. 

the QUERY command, 
an attention interruption to the virtual 

to simulate a real request key 
ion. 



Pageable. 

Processes LOCATE and ADSTOP commands. 

Stops virtual machine at specified address 

(ADSTOP command) . 

Displays address of real device blocks, or VMBLOK 

and/or virtual device blocks (LOCATE command) . 

Pageable. 

Handles Diagnose code 1 1 6H 1 . 

Entry to IPL from LOGON (DMKLOG) . 

Entry to IPL from a command line (DMKCFM) . 

Pageable. 

Saves a virtual machine's storage space including 

registers and PSW (SAVED System) . 

Resident. 

Processes DIAGNOSE code 8. It scans the command 

line and goes to the required module. 

Posts an attention interrupt pending for the 

virtual machine. 

Puts the terminal in console function (CP) mode 

(ATTN key pressed twice) . Scans the command line 

and goes to the command handling routine. 

Entered when DIAGNOSE code 8 is executed. Scans 

the command line and goes to the command handling 

routine. 
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CP Module Entry Point Directory 



Module 
Name 



Entry 
Points 



Attributes, Function 



DMKCFO 



DMKCFP 



DMKCFS 



DMKCFT 



DMKCKP 



DMKCKS 



DMKCLK 



DMKCNS 



DMKCFOEX 

DMKCFPRD 
DMKCFPRR 

DMKCFSET 
DMKCFTRM 
DMKCKPT 



DMKCKSPL 
DMKCKSIN 
DMKCKSWM 



DMKCLKCK 

DMKCLKCC 
DMKCLKMP 
DMKCLKAP 
DMKCLKSC 



DMKCNSED 



DMKCNSEN 
DMKCNSIC 



Pageable. 

Processes Class A, B, C, and F SET commands. 

Pageable. 

Simulates the operator's console for the virtual 

machine. 

Handles virtual device reset for other CP 

routines. 

Handles system resets for other CP routines. 

Resets the virtual machine. 

Pageable. 

Processes the CP SET command for general users. 

Entry point for SET command processor. 

Pageable. 

Processes user , s terminal options. 

Entry point for the TERMINAL command processor. 

Pageable. 

Saves pertinent data when a check point occurs. 
Retrieves accounting data from the VHBLOK, 
VDEVBLOK, and unpunched accounting cards. It 
retrieves accounting information for dedicated 
devices, saves the system log messages, and saves 
all control blocks for spool files. The data is 
written on the SYSWARM cylinder of the IPL pack. 
DMKCKP is loaded and executed by DMKDMP or 
initial program load. 

Pageable. 

Performs checkpoint processing. 

Performs a checkpoint on any alterations in the 

spool file set up to allow the recovery routine 

to get them if warm start fails. 

Initializes the check point cylinder after a 

successful warm start from the standard recovery 

procedure or after a cold start. 

Recovers previously checkpointed spool file 

information. This information includes all open 

print or punch files in existence at the time the 

system went down or was shutdown. All open spool 

files are put in user hold status. 

Pageable. 

Determines if the clock should be synchronized. 

(Called from DMKCPI) 

Handles CLKCHK signal reguest. 

Synchronizes the clocks. 

Handles SYNC signal request. 

Handles the TOD-sync-check external interrupt. 

Resident. 

Real console terminal manager. 

Edits the input line for the following 

characters: escape, line end, line delete, and 

character delete. 

Enables or disables a low-speed terminal line. 

Entered from DMKQCN to initialize read and write 

CCWs for the CONTASK built by DMKQCN. 
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CP Mflflnlp Sntn Do-Jri-t- niror+nm 



Module 
Name 



Entry 
Points 



Attributes, Function 



DMKCPB 



DMKCPE 



DMKCPI 



DMKCPS 



DMKCPU 



DMKCPV 



DMKCNSIN 



DMKCPBEX 
DMKCPBNR 
DMKCPBRS 

•nMBT , T>X}X>D 

1/ilUVl JJUR 

DMKCPBRY 
DMKCPBSR 



DMKCPIEM 



DMKCPINT 



DMKCPSSH 

DMKCPSH 

DMKCPSRY 



DMKCPUVY 
DMKCPUUP 



DMKCPVAA 
DMKCPVAC 



DHKCPVAE 
DMKCPVDS 

DMKCPVEN 
DHKCPVLK 

DMKCPVOL 



Interruption return point 
terminal I/O. 



and handler for 



Pageable. 

Simulates the operator's console for the virtual 

machine. 

Processes 

external ii 

Processes 

virtual dei 

Processes 

interrupts 



the EXTERNAL 
.nterruption to 
the NOTREADY 
svice to appear 
the RESET comma 
from the speci 
Processes the REWIND co mm 
the real tape device. 
Processes the READY comma 
end interrupt to the spec 
Processes the SYSTEM com 
reset and PSW restart 
storage. 



command to present an 
the virtual machine. 

command to cause the 
not ready. 

nd to reset all pending 
fied device, 
and to issue a rewind to 



nd to simulate a device 
ified device, 
mand to simulate system 
to allow clearing of 



Resident. 

Contains data constants that 

the CP nucleus. 



define the end of 



initializes the 
operator logon, 
and completes 



Pageable. 

Prepares VM/370 for operation. 

Enables the operator's console, 

TOD clock and directory, allows 

prepares for warm start, 

initialization. 

Initializes and prepares CP for operation. 

Pageable. 

Processes the SHUTDOWN, HALT, and VARY commands. 

Processes the SHUTDOWN command. 

Processes the HALT command. 

Processes the VARY command. 

Pageable. 

Processes the VARY PROCESSOR command. 

Causes the system to convert to uniprocessor 

mode. 

Pageable. 

Punches user accounting records. 

Processes the ACNT command to create accounting 

records for logged-on users. Also, resets 

accumulated accounting information. 

Enables system low-speed lines 

restart. 

Processes the DISABLE command to 

active line after the current user 

with it. 

Processes the ENABLE command to 

system's low-speed lines for system logon. 

Processes the LOCK command to lock specified 

pages of a user's virtual storage space into real 

main storage. 

Processes the UNLOCK command to unlock pages that 

were locked by operator command (LOCK) . 



for system 

disable an 

is finished 

enable the 
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CP Module Entry Point Directory 



I Module 


Entry 




t Name 
1 


Points 


Attributes, Function I 

i 


t 




r 1 


I DMKCQG 




Pageable. 1 
Processes the class G and class D QUERY commands. | 




DMKCQGEN 


Entry to QUERY command processor for class G | 
users. 1 


| DMKCQH 




Pageable. I 




DMKCQHRD 


Processes QUERY RDR command, I 




DMKCQHPR 


Processes QUERY PRT command. j 




DMKCQHPU 


Processes QUERY PCH command. | 


I DMKCQP 




Pageable. I 
Processes the class B and class G QUERY command. | 




DMKCQPRV 


Entry to QUERY command processor for class B and j 
G users. | 


! DMKCQR 




Pageable. 1 
Processes the QUERY command. | 




DMKCQREY 


Main entry point. Contains a branch table to get | 
to the routine that processes the operand | 
specified in the QUERY command; the operand can I 
be one of the following: FILES, SET, DUMP, I 
PAGING, HOLD, PRIORITY, and TERMINAL. | 




DMKCQRFI 


Retrieves the number of reader, punch, and print j 
files. I 


I DMKCQY 




Pageable. 1 




DMKCQYEY 


Handles QUERY functions: TIME, LOGMSG, NAME, | 
USERS, PF, SASSIST, CPASSIST, and CPUID. | 


I DMKCSB 


DMKCSBLD 


Processes the LOADBUF command | 
(real UCS or FCB buffer) . j 




DMKCSBVL 


Processes the LOADVFCB (load virtual forms | 
control buffer) command. j 


I DMKCSO 




Pageable. I 
Processes real spooling commands for real unit I 
record devices. I 




DMKCSOBS 


Processes the BACKSPACE command. | 




DMKCSODR 


Processes the DRAIN command. | 




DMKCSOFL 


Processes the FLUSH command. j 




DMKCSORP 


Processes the REPEAT command. | 




DMKCSOSD 


Restarts a device after it has been drained. | 




DMKCSOSP 


Processes the SPACE command. | 




DMKCSOST 


Processes the START command by device type. | 


| DMKCSP 




Pageable. | 
Processes class D and G spooling commands. | 


I DMKCSQ 




Pageable. | 




DMKCSQCL 


Processes the CLOSE command. | 




DMKCSQHL 


Processes the HOLD command. | 




DMKCSQRF 


Processes the FREE command. j 


1 DMKCST 




Pageable. I 
Processes class G commands. | 




DMKCSTAG 


Entry point to process the TAG command. j 


| DMKCSU 




Pageable. | 
Processes the class D and G spooling commands. | 




DMKCSUCH 


Processes the CHANGE command. | 
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CP Module Entry Point Directory 



Module 
Name 



Entry 
Points 



Attributes, Function 



DMKCSV I I Pageable. 

DMKCSVOR | Processes the ORDER command. 

DMKCSTPU i Processes the PURGE command. 

DMKCSVTR I Processes the TRANSFER command. 

DMKCVT I I Resident. 

Processes the conversion routines. 
DMKCVTBD I Converts a word of binary data into a doubleword 

of decimal digits. 
DMKCVTBH I Converts a word of binary data into a doubleword 

of hexadecimal data. 
DMKCVTDB I Converts a decimal field into a fullword of 

binary data. 
DMKCfTDT i Converts data and time to EBCDIC and inserts it 

into a specified location. 
DMKCVTFP I Converts a floating-point doubleword into 17 

bytes of decimal data. 
DMKCVTHB I Converts the designated hexadecimal field into a 

binary fullword. 

DMKDAS | | Resident. 

DASD error retry program. 
DMKDASER | Retries the failing DASD channel program. 
DMKDASRD | Processes unsolicited device end interruptions. 
DMKDASSD i Collects DASD sense data. 

DMKDDR I I Residency not applicable. 

This is the DASD dump restore program. It saves 
data from a direct access volume onto a tape or 
tapes. It returns data to DASD from tape that has 
been placed on the tape by this program. It 
copies data from one device to another of the 
same type. It prints a translation of each record 
specified on the SYSPRINT device. Prints a 
translation of each record specified on the 
console. Initial program loaded or run under CHS 
if on a CMS disk. 

DASD dump restore program entry point. 
End- of- load module for CMS. 

DMKDEF | | Pageable. 

Processes the DEFINE command to define a virtual 
device or storage. 

Processes the DEFINE command to alter the virtual 
machine 1 s configuration or storage size. 

Resident. 

Processes simple disk I/O. 

Performs simple disk I/O of a standardized format 

with a minimum of CCW chain manipulation and 

interruption handling. 

DMKDIA I I Pageable. 

COUPLE command processor. Establishes a virtual 
connection between two channel-to-channel 
adapters on a single virtual machine. 
Releases a terminal line that has been in use by 
the virtual machine via the DIAL command. The 
line is detached from the virtual machine and 
made available for normal log on to VM/370. 



DMKDGD 



DMKDDREP 
DMKDDRED 



DMKDEFIN 



DMKDGDDK 



DMKDIACP 



DMKDIADR 
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CP Module Entry Point Directory 



Nodule 
Name 



Entry 
Points 



Attributes, Function 



DMKDIAL | Processes the DIAL command. Attaches a user's 
terminal as a dedicated device to an existing 
virtual 270X terminal line in the virtual machine 
addressed by the command line. 

DHKDIB I | Pageable 

DMKDIBSM I Simulates sense data and status for virtual I/O 
to a simulated I/O device (2702 line or CTCA) 
that has not yet been activated through either 
the console function DIAL for 2702 lines, or the 
console function COUPLE for virtual CTCAs. 

DMKDIR | | Pageable or standalone. 

Initial program loaded or run under CMS if on a 

CMS disk. 
DMKDIRCT I Builds a user directory on a system owned volume 

using pre-allocated cylinders. 
DMKDIRED | End of load module for CMS. 

DMKDMP I I Resident. 

Writes a dump of main storage, control registers, 
floating-point registers, general registers, and 
clocks to a specified device. 

DMKDMPDK | Writes the dump on the specified device. 

DMKDMPRS I Initial program loads the system over again. 

DMKDRD I I Pageable. 

Process spool files 
DMKDRDDD | Delete system dump spool file. 
DMKDRDER I Manipulates input spool files via a DIAGNOSE code 

X'OOH' issued by the virtual machine. 
DMKDRDMP | Reads a system dump spool file via a DIAGNOSE 

code I'DOai* issued by the virtual machine. 
DMKDRDSY I Reads the system symbol table CSECT via a 

DIAGNOSE code X'0038' issued by the virtual 

machine. 

DMKDSB | | Resident. 

DASD error retry program. 
DMKDSBRD | Processes unsolicited device end interruptions. 
DMKDSBSD | Collects DASD sense data. 

DMKDSP I I Resident. 

Entered after each interruption handler is 
finished processing and after each stacked 
CPEXBLOK, I/O request, and external interruption 
has been serviced. It updates the CPO times 
charged to the user that has received service, 
updates all virtual timers, and reflects any 
pending interruptions for which the user is 
enabled. After the user's status has been 
updated, the highest-priority runnable user is 
dispatched. 
DMKDSPA | Immediate redispatch path for virtual machines. 
The only status update that occurs is for virtual 
timers. 
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DMKEIG 



DMKEMA 



DMKEMB 



DMKEMC 



DHKDSPB 



DMKDSPCH 



DMKDSPO 
DMKDSP1 
DHKDSP2 
DMKDSPE 
DHKDSPQS 

DMKDSPRQ 
DMKD5PRU 

DMKDSPNP 



DMKEMA 



DMKEMB 



DMKEMC 



Process new virtual PSW and dispatch. Entered if 

the virtual PSW has been entered outside of 

DMKDSP. 

Main entry point. Updates timers and dispatches 

user. 

CP assist DSPO instruction (E60D) . 

CP assist DSP1 instruction (E607) . 

CP assist DSP2 instruction (E611) . 

Processes interrupt from virtual interval timer. 

Nonexecutable; dispatched user's maximum time 

slice. 

Queues anchor for IOBLOKs and CPEXBLOKs. 

Entered in attached processor mode when the 

system lock is not held. 

Number of dynamically assignable page frames now 

available in the system. 

Pageable. 

Analyzes the 2880 channel logout and sets 
appropriate bits in the ECSW field according to 
the results of this analysis. It moves the 
channel logout to the channel check record. 

Pageable. 

Contains the framework of the common error 
messages that are generated at various places 
within CP. Module DMKERM references DMKEMA to 
write error messages that require variable data 
to be inserted into them. This module contains 
no executable code and contains all error 
messages from to 169. 

Pageable. 

Contains the framework for the common error 
messages that are generated at various places 
within CP. The module DMKERM references DMKEMB to 
write error messages that require variable data 
to be inserted into them. This module contains 
no executable code and contains all error 
messages from 170 to 423. 

Pageable. 

Contains the framework of the common error 
messages that are generated at various places 
within CP. Module DMKERM references DMKEMC to 
write error messages that require variable data 
to be inserted into them. This module contains 
no executable code and contains error messages 
424 and up. 
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Name 



Entry 
Points 



Attributes, Function 



DMKENT 



DMKERM 



DMKENTEC 
DMKEHTET 
DMKENTFI 
DMKENTKC 
DMKENTSC 
DMKENTST 
DMKENTTI 
DMKENT62 

DMKERMSG 



DMKEXT 



DMKFCB 



DMKEXTSP 
DMKEXTSL 

DMKFCB 



DMKFMT 



Resident. 

Meets the CP nucleus residency requirements for 

TRQBLOK and CPEXBLOK entries to pageable VH 

Monitor module DMKHIA. 

Used to invoke a MONITOR STOP command via a 

CPEXBLOK. 

Used to invoke a MONITOR STOP command via a 

TRQBLOK request. 

Used to complete monitor shutdown processing, via 

CPEXBLOK. 

Used to invoke a MONITOR CLOSE command via a 

CPEXBLOK. 

Used to invoke a MONITOR START SPOOL command via 

a CPEXBLOK. 

Used to invoke a MONITOR START SPOOL command via 

a TRQBLOK request. 

High frequency I/O status sampling routine, 

entered every two seconds via TRQBLOK request. 

DASTAP class 6 code 2 I/O status sampling 

routine, called from DMKHONTI every 60 seconds to 

collect the data accumulated by DMKENTTI. 

Pageable. 

This is the message writer. Locates the 

requested message and inserts the module ID, 

message number, and data. It also prints the 

message. 



Resident 

Handles all SIGNAL actions after 

initialization. 

Entry point for External Interrupt handler 



CP 



Pageable. 

Contains the forms control load buffer images 
that the LOADBUF command uses to load the forms 
control buffer in the 3811 control unit for the 
3203 or 3211 printer. The LOADVFCB command also 
uses DMKFCB to load the forms control buffer in 
the virtual 3203 or 3211 printer. 

Standalone program. 

Initial program loaded or run under CMS if on a 
CMS disk. Adapts parameters from the console or 
IPL device (card reader) and per forms partial or 
complete formatting, allocating, and labeling of 
2314, 2319, 3330, 3340, 3350 and 2305 DASD 
devices. The FORMAT program also write-checks the 
surfaces. Bad surfaces are flagged to prevent 
their use. No alternative tracks are assigned. OS 
labels are written to be compatible with OS, but 
labels indicate to OS that no space is left on 
the DASD device. All input parameters are 
verified for correctness. 
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DMKFRE 



nMtrcTn 



DMKGRF 



DMKGRT 



DMKGRW 



DMKHVC 



DMKHVD 



DMKIOC 



DMKFREE 
DMKFRERC 



DMKFRERS 
DMKFRET 

DMKFRETR 



DMKGIOEX 



DMKGRFIN 
DMKGRFEN 
DMKGRFIC 



DMKGRTAB 



BMKGRTFM 



DMKHVCAL 



DMKHVDAL 



Resident. 

Free storage manager. 

Gets space from free storage and processes the CP 

assist FREE instruction (E600) . 

Special entry point to acquire free storage. If 

the storage request cannot be satisfied, a 

condition code of one is returned to the caller. 

Returns subpools to free storage chain. 

Returns space to free storage and processes the 

CP assist FRET instruction (E601) . 

Returns space to free storage; does not release 

pages. 

Pageable. 

Initializes supervisor operations for tape, unit 
record, and nonstandard disk I/O operations. 
Checks device validity and initializes I/O 
operations on tape, unit record, and nonstandard 
disk I/O programs per supervisor call . This 
module presents resultant condition code and CSH 
(if warranted) to the user. 

Resident. 

Supports local 3270, 3278 Model 2A, and 3066 
devices. DMKGRF processes interruptions and CCSs 
for the devices. The processing includes message 
handling and screen management. 
Handles the interruption via an IOBLOK. 
Enables or disables the device. 
Starts a CONTASK from DMKQCN. 

Resident. 

Contains common data area and subroutines for 

3270 display support. 

Computes the next tab position and creates the 

data stream to position the cursor and insert a 

logical tab character if necessary. 

Brings in the Vn/370 logo and initializes buffer 

and the CCWs to write the logo in DMKGRT and 

DMKRGB. 

Non-executable. 

Contains CCWs and data for 3278 Model 2A operator 

display console. 

Resident. 

Performs services for the virtual machine as 
requested via the DIAGNOSE instruction. The 
specific service performed depends on the code in 
the DIAGNOSE instruction. 

Pageable. 

Performs services for virtual machines as 
requested by the DIAGNOSE instruction. 



DMKIOCVT | Converts VM/370 device type to OS/VS device type. 

j 1 , . .. -. — i 
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DMKIOE 



DMKIOF 



DMKIOECC 

DMKIOECH 

DMKIOECJ 

DMKIOEFL 

DMKIOEFM 

DMKIOEMC 
DMKIOEMH 
DMKIOENV 

DMKIOEOB 

DMKIOEQQ 

DMKIOERC 
DMKIOERN 
DMKIOERR 

DMKIOESD 
DMKIOESR 
DMKIOEST 

DMKIOEVR 



DMKIOFC1 

DMKIOFIN 

DMKIOFOB 
DMKIOFM1 
DMKIOFST 
DMKIOFVR 



Resident. 

This is the error recording nodule. It receives 

all requests for error recording and passes 

control to the proper pageable routine after 

checking if a recording is in progress. If a 

previous request for error recording is in 

progress, the current request is queued on the 

appropriate queue for recording at a later time. 

It makes a check to determine if the recording 

cylinder is full. DMKIOE also interfaces with the 

pageable module that initializes and erases the 

error recording cylinders. 

Entry for a channel error condition occurring on 

a SIO in DMKIOS with a response condition code of 

one. 

Entry for a stacked channel recording request 

from the channel check handler. 

Entry for a stacked channel check recording 

request from ERP. 

Entry point to locate the starting page record 

for recording. 

Entry to clear and format the recording area on 

disk. 

Entry for machine check recording. 

Entry for a stacked machine check request. 

Entry for a stacked environmental recording 

request. 

Entry for a stacked outboard error recording 

request. 

Calls to initiate error recording via DMKIOF (no 

DMKIOE function performed) . 

Entry for a stacked erase request. 

Processes a 3704/3705 and remote 3270 request. 

Schedules recording for unit check, channel data 

check, and hardware environmental counts. 

Records 3330 data. 

Schedules statistical data recording. 

Schedules the update of a statistical data 

request. 

Processes an SVC 76 request. 

Pageable. 

Records system and I/O errors on the system disk 

in predefined error recording cylinders. 

Records channel check error from SIO in DMKIOS 

when cc=1. 

Initializes pointers to available recording pages 

at IPL and after an erase has been completed. 

Records OBR and MDR records. 

Records machine checks. 

Updates statistical data counters. 

Records errors when requested by SVC 76. 
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DMKIOG 



DMKIOS 



DMKISM 



DMKJRL 



DMKLDOO 



DMKLNK 



DHKIOGFR 



DMKIOGF1 
DMKIOGF2 



DMKIOSHA 

DMKIOSIN 
DMKIOSQR 
DMKIOSQV 
DMKIOSRW 



DMKISMTR 



DMKJRLQU 
DMKJRLSE 
DMKJRLLG 
DMKJRLSL 
DMKJRLIL 



LDRGEN 



DMKEPSWD 



DMKLNKIN 



DMKLNKSB 



Pageable. 

Called at initialization to locate the error 

recording device, locate the last outboard error 

record and system recordings made on the 

cylinders, and set the in-storage pointers to the 

correct values- Initialization for RHS functions 

is performed after first making a test to 

determine if CP is running under CP- RMS 

functions are not activated for a virtual CP 

environment- This module also erases the 

recording areas. 

For 3031/3032/3033 processors, reads frames from 

the SRF device, formats them in 4096-byte blocks, 

or»r[ t»^j_4-gc! *-Vi@ record* 5 ^o ■'■^e error recording 

cylinders. 

Contains all function of DMKIOG except erase. 

Erases (1) error records or (2) error records and 

frame records from the error recording cylinders, 

depending on input parameters. 

Resident. 

Schedules requests for virtual machine and 

program I/O operations, and services all I/O 

interruptions. 

Halts an active device and drains all 

interruptions. 

Processes an I/O interruption. 

Schedules CP-generated I/O operation. 

Schedules a virtual machine I/O operation. 

Processes the IOBLOK used for REWIND. 

Pageable. 

Finds and modifies an ISAM CCW string. 

Pageable. 

Processes the QUERY command. 

Processes the SET JOURNAL command. 

Processes LOGONS with invalid passwords. 

Processes LINKs which are successful. 

Processes LINKs with invalid passwords. 

Loader - utility program. 

Loads assembled program modules into storage at 
locations other than those assigned by the 
assembler. It completes linkage among the 
modules and transfers control to one of the 
loaded modules for execution. 

Pageable. 

Prompts the user to enter a password, types 

masking characters if appropriate, reads the 

password from the terminal, and checks it for a 

match. 

Links to a virtual DASD because of an issued LINK 

command. 

LINK subroutines. 
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i 


| Module 


Entry 




I Name 

i 


Points 

i 


Attributes, Function 1 

I 


r 

| DMKLOC 


r 


i 

Resident. 1 




DMKLOCK 


Allows a system resource to be Barked in use or | 
not available by a unique 8-character name. 1 




DMKLOCKD 


Dequeues a locked name. I 




DMKLOCKQ 


Queues or locks a name. | 




DMKLOCKT 


Tests to determine if a name is locked. | 


I DMKLOG 




Pageable. i 
Logs on a user or operator. | 




DMKLOGA 


Processes the ADTOLOG command. | 




DMKLOGON 


Logs on a user. | 




DMKLOGOP 


Logs on the operator. | 


I DMKLOH 




Pageable. I 




DMKLOHON 


Constructs and sends logon-related messages to a | 
user or to the operator. | 


| DMKLOK 




Resident. I 




DMKLOK 


handles all locking reguests when CP is in I 
attached processor mode. | 




DMKLOKDF 


Processes an obtain, defer lock request. | 




DMKLOKPS 


Processes all spin lock requests. | 




DMKLOKSO 


Processes an obtain, defer request for VMBLCK | 
lock. I 




DMKLOKSP 


Processes an obtain request for a spin lock that | 
previously failed. | 




DMKLOKYM 


Processes an obtain, defer request for VMBLCK | 
lock. I 




DMKLOKVR 


Processes a release request for VMBLOK lock. | 


I DMKMCC 




Pageable. I 




DMKMCCCL 


Handles first level MONITOR command processing. | 


| DMKMCD 




Pageable. I 




DHKMCDIN 


Processes MONITOR INTERVAL commands. | 




DMKMCDLI 


Processes MONITOR LIMIT commands. j 




DMKMCDTI 


Processes MONITOR TIME commands. | 




DMKMCDST 


Processes MONITOR STOP commands. | 




DMKHCDSE 


Processes MONITOR SEEKS commands. | 


I DMKMCH 




Resident. I 




DMKMCHIN 


Processes. a machine check interruption. | 




DMKMCHMS 


Enables or disables soft machine check recording. | 


I DMKMCT 




Resident. I 
This module is called by the machine check | 
handler in attached processor mode. | 




DMKMCTMA 


Handles malfunction alert. | 




DMKMCTPR 


Handles processor recovery. | 




DMKMCTPT 


Handles processor termination. | 




DMKMCTST 


Handles system termination. | 


| DMKMIA 




Pageable. I 
Provides various facilities associated with | 
automatic monitoring using spool files. | 




DMKMIACC 


Used for MONITOR CLOSE processing. | 




DMKMIADL 


Used for DMKMCC display function. | 




DMKMIAEN 


Used to invoke a MONITOR STOP coimand. | 




DMKMIAIN 


Used to invoke a MONITOR START command. | 




DMKMIAKC 


Used to invoke a MONITOR CLOSE command. | 
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DMKMID 



DMKMNI 



DMKMON 



DMKK5G 



DHKMSW 



DMKMIAMU 

DMKMIARO 
DMKMIAST 

DMKMIAWO 



DMKMIDNT 



DMKMNIDK 
DMKMNIDS 

DMKMNIFI 
DMKMNISH 
DMKMNISP 

DMKMNITH 
DMKMNITR 



DMKMONIO 
DMKMONMI 
DMKMONPR 

DMKMON00 

DMKMON40 

DMKMONTI 



Generates informational messages for monitor 

user. 

Opens monitor spool file, gets SFB, etc. 

Schedules, via TRQBLOKs, requests to start and 

stop monitor at specific times in the future. 

Writes a monitor data buffer to a spool file 

buffer. 

Pageable. 

Changes the date in the system low storage at 
midnight and resets the clock comparator for the 
next midnight occurrence. DMKMID also sends 
messages to all users about the date change. 

Pageable. 

Constructs spool file header record. 

Displays automatic monitoring information defined 

by SYSMON macro in DMKSYS. 

Completes monitor shutdown. 

Initializes MONITOR shutdown. 

Handles monitor processing for SPOOL to DSERID 

parmeters of START command. 

Handles monitor tape header processing. 

Writes the MONITOR trailor record. 



Pageable. 

Processes commands and requests 

the MONITOR, including MONITOR C 

within CP. 

Processes tape interruptions ret 

Processes a MONITOR CALL program 

Gets space for monitor reco 

buffers. 

Handles PERFORM (class zero) 

routine. 

Handles USER (class four) 

routine. 

Handle timer request interruptio 



associated with 
ALL interruptions 

urned by DMKIOS. 

interruption, 
rd and manages 

data collection 

data collection 

ns. 



Pageable. 
Transmits 



messages to lcgged-on users for the 



commands. Receives and 
ECHO command for the 



MESSAGE, SMSG, or WARNING 
retransmits lines for the 
number of times specified. 
ECHO command processor. 
MESSAGE command processor. 
HSGNOH command processor. 
SMSG command processor. 
WARNING command processor. 

Resident. 

Allows system communication with the operator for 

the enhancement of error recovery procedures. 

DMKNEM | 1 Pageable. 

Gets a 5-byte mnemonic opcode for a System/370 
binary opcode. 



DMKMSGEC 
DMKMSGMS 
DMKMSGNH 
DMKMSGSM 
DMKMSGWN 



DMKMSWR 



DMKNEMOP 
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DHKNES 



DMKNET 



DMKNLD 



DMKNLE 



DMKOPR 



DMKPAG 



DMKPER 



DMKPGS 



DMKNESDS 
DMKNESEP 

DMKNESHD 
DMKNESPL 
DMKNESTR 
DMKNESWN 



DMKNETAE 
DMKNETWK 



DMKNLDMP 
DMKNLDR 



DMKNLEMP 



DMKOPRWT 



DMKPAGIO 



DMKPERCH 
DMKPERIL 
DMKPERT 



DHKPGSPO 



DMKPGSPP 
DMKPGSPR 



Pageable. 

Processes NETWORK operands as follows: POLLDLAY 

SHUTDOWN DISPLAY VARY TRACE 

Processes the NETWORK DISPLAY command. 

Processes the NETWORK VARY EP command to switch 

an NCP communication line to EP mode. 

Processes the NETWORK SHUTDOWN command. 

Processes the NETWORK POLLDLAY command. 

Processes the NETWORK TRACE command. 

Processes the NETWORK VARY NCP command to switch 

an EP communication line to NCP mode. 

Pageable. 

Decodes NETWORK command and enables bisync lines. 

Enable binary synchronous lines and remote 

stations. 

NETWORK command decoder. 

Pageable. 

Dumps the 3705 network control program. 

Loads the 3705 network control program. These 

routines may be called by a console command from 

DHKNET or or internally by DMKCPI (for LOAD) or 

DMKRNH (for DUMP) . 

Pageable. 

Dump the 3705 Network Control Program. 

Resident. 

Provides the necessary support for the VM/370 
system console. Certain routines within the 
control program cannot call DMKQCN to issue 
writes to the system console. This module 
determines the system's primary console and 
builds a channel program to handle the requested 
call. 

Resident. 

Constructs IOBLOKs and schedules the tasks that 

move virtual storage pages between auxiliary 

storage and main storage. It also calculates the 

total system paging load at user-specified 

intervals. 

Pageable. 

Sets a return code of zero in R2. 
Resets the interruption. 
Resets program event recording. 

Pageable. 

Release all the pages of a user's virtual storage 

from the real storage and from auxiliary storage 

on the paging device. 

Releases a specified part of virtual storage. 

Calls DMKPTRPU to ensure that the user is not in 

page wait and then releases the address range 

contained in R1 through R2. It also unlocks any 

pages that might have been locked. 
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DMKPGT 



DMKPRG 



DMKPRV 



DMKPSA 



DMKPTR 



DMKPGTCG 
DMKPGTPG 



DMKPGTPR 

DMKPGTSD 

DMKPGTSG 
DMKPGTSR 

DMKPGT7G 

DMKPGTVR 



DMKPRGIN 
DMKPRGRF 

DMKPRGSM 



DMKPRVLG 



DMKPSACG 
DMKPSADU 

DMKPSAEX 
DMKPSAFC 
DMKPSAFP 

DMKPSAID 
DMKPSARR 
DMKPSARS 

DMKPSARX 
DMKPSASC 
DMKPSASP 



DMKPTRAN 

DMKPTRFR 
DMKPTRFT 
DMKPTRLK 

DMKPTRPW 



DMKPTRUL 



Resident. 

DASD storage management. 

Allocates contiguous space for a 

Allocates a page of DASD sto 

virtual storage paging cr for 

buffers. 

Releases DASD storage used for 

paging. 

Releases one page of EASD s 

spooling. 

Allocates a page of DASD storage 

Releases a group of DASD storag 

spooling. 

Allocates a page of virtual sto 

the CP paging VMBLOK. 

Releases a virtual storage page. 



3704/3705 dump. 

rage for either 

spool file page 

virtual storage 

torage used for 

for spooling, 
e pages used for 

rage belonging to 



Resident. 

Processes a hardware program interruption. 

Reflects an SVC interruption to the virtual 

machine. 

Simulates a virtual program interruption. 

Resident. 

Simulates a privileged operation. 

Resident. 

Charges accumulated time to a virtual machine. 

PSW restart processing. Forces an SVC type of 

dump. 

Processes external interruptions. 

Checks fetch protection per the CAW key. 

Checks for fetch protection violation per PSW 

key. 

Gets virtual address for any instruction. 

Gets the virtual address for an RR instruction. 

Gets the virtual address for RS, SI, or SS 

instruction. 

Gets the virtual address for an RX instruction. 

Checks storage protection per the CAW key. 

Checks for a storage protection violation per the 

PSW key. 

Resident. 

Manages the inventory of real system pages, 

provides real storage space for CP functions and 

for pages of user and CP virtual storage. 

Translates user virtual storage address to a real 

storage address. 

Gets a page of real storage. 

Releases a page of real storage. 

Locks a page of real storage and processes the CP 

assist instruction, PTRLK (E602) . 

Called to defer execution of system reset 

functions when user's virtual machine is in page 

wait. 

Unlocks a page of real storage and processes the 

CP assist instruction, PTROL (E603) . 
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DMKQCN | | Resident. 

DMKQCNCL | Clears CONTASK stack and returns all blocks to 
free storage. 

DMKQCHET | Processes completed CONTASKS for virtual console 
spooling, return or no return options, and 
returns the CONTASK blocks to free storage. 

DMKQCNRD | Starts and queues a console read request. 

DMKQCNSY | Synchronizes virtual machine console activity 
with internal supervisor activity. This is used 
during a virtual system reset and during the 
logoff process. 

DMKQCNTO | Disconnects a virtual machine and sets a TCD 
clock comparator request to log off the virtual 
machine after a fifteen-minute delay. 

DMKQCNWT I Starts and queues a console write request. 

DMKRGA | ! Resident. 

DMKRGAIN I This is the second- level interruption handler for 
remote 3270 stations. This module supports the 
3270 remote display and printer stations. It 
processes interruptions and CCws for the remote 
stations, including message handling and screen 
management. 

DMKRGB | | Resident. 

Supports the 3270 remote display and printer 

stations. It processes interruptions and CCWs for 

the remote stations including message handling 

and screen management. 

Initializes and schedules CONTASKs. 

Enables and disables bisync lines and remote 

stations. 

DMKRIO I I Resident. 

Exists as a CSECT and defines the machine's 
configuration. A basic DMKRIO is shipped with 
VM/370. DMKRIO can be changed at system 
generation or whenever new machines are added by 
using the appropriate macros. 

DMKRND | | Residency not applicable. Invoked 

via the NCPDUMP command in CMS. 
DMKRND | This is the interface between the VM/370 dump 
spool file and the OS-SSP dump format program for 
printing and formatting dumps of the 3704 and 
3705 communications controllers. 

DMKRNII I | Resident. 

DMKRNHIC | Initializes and schedules the CONTASK fields that 

comprise the 3704 and 3705 Network Control 

Program transmission header. 
DMKRNHIN I This is the secondary interruption handler for 

the 3704 and 3705 communication controllers; it 

is read when operating in NCP or PEP mode. 
DMKRNHND | Schedules control functions for the 3705 or 3704 

Network Control Program. 



DMKRGB 



DMKRGBIC 
DMKRGBEN 



DMKRIO 
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DMKRPA 



DMKRSE 



DMKRSP 



DMKSAV 



DMKSCH 



DMKSCN 



DMKRPAGT 
DMKRPAPT 



DMKRSERR 
DMKRSESD 



DMKRSPER 
DMKRSPEX 



DMKRSPUR 



DMKSAVNC 
DMKSAVRS 



DMKSCHAE 

DMKSCHBK 
DMKSCHCP 
DMKSCHDL 
DMKSCHMD 
DMKSCHRT 
DMKSCHST 

DMKSCH80 



DMKSCNAU 



DMKSCNFD 



Resident. 

Virtual storage mapping. 

Page-in from DASD to user's virtual storage. 

Page-out to DASD from user's virtual storage, 



Pageable. 

Real UR device I/O error handler. 

Retries and attempts to recover from 

record device I/O errors. 

Collects 3800 sense data. 



real unit 



Resident. 

Manages all spooling operations on the real 

system unit record devices including printing and 

punching user-created spool files and reading and 

queueing reader files from the real card reader. 

Processes spooling errors (ERP) . 

Processes spooling operations. Entered via a GOTO 

when DMKDSPCH unstacks an IOBLOK with an 

interruption for the spooling unit record device. 

Formats the active file message for real unit 

record devices. 

Pageable. 

DMKSAVNC is entered via an LDT card from DMKLDR. 
DMKSAVRS is entered via a BALR from DMKCKF. 
DMKSAV saves and restores a page image count of 
the CP nucleus on the system residence disk. 
Writes a page image copy of the CP nucleus. 
Restores a page image copy of the CP nucleus. 

Resident. 

Maintains queues of runnable and eligible users, 
alters the dispatching status of users, and 
periodically recalculates the working set size 
and dispatching priority of users. DMKSCH 
contains the routines that maintain the system 
TOD clock comparator request queue and the code 
that monitors users with abnormal execution. 
Processes the interrupt occurring when the 
favored execution measurement interval expires. 
From DMKTMR. Calculates problem state time. 
Interruption from real CPU timer. 
Alters a user's dispatching status. 
Interruption for the midnight date change. 
Resets a clock comparator interruption request. 
Establishes a clock comparator interruption 
request. 

Interruption for real timer at storage address 
80. 

Resident. 

Scans module. 

Searches the chain of VMBLOKs for one whose 

userid matches the one pointed to by register 

one. 

Finds the next field in an input message buffer. 
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Module 
Name 



Entry 
Points 



Attributes, Function 



DMKSEP 



DMKSEV 



DMKSCNLI 

DMKSCNP 
DMKSCNRA 

DMKSCNRD 

DMKSCNRN 
DMKSCNRD 

DMKSCNVD 

DMKSCNVN 
DMKSCNVS 

DMKSCNVD 

DMKSEPSP 
DMKSEV70 



DMKSIX 



DMKSNC 



DMKSNCP 



Searches the logged- on virtual machines for any 

links to a specified minidisk. A link is any 

virtual device whose ADEVBLOK pointer and 

relocation factor match those specified. 

Finds the RCHBLOK and RCUELOK that represents the 

next logical path to the device. 

Computes a full real device address (in cuu form) 

from the RDEVADD, RCUADD, and TCHADD entries in 

the real device, control unit, and channel 

blocks. 

Computes a real device address (in CW form) , from 

the RDEVADD, RCOADD, and RCHADD entries in the 

real device, control unit, and channel blocks. 



Returns the name of the real device to th 

in register 1. 

Returns the addresses of the real 

control unit, and device blocks for a gi 

device to to the caller. 

Computes a full virtual device address 

form) , plus the addresses of the virtual 

and control unit blocks from a specific 

device block. 

Returns the name of the virtual device 

caller in R1. 

Searches all the real device blocks for 

whose volume serial number matches 

pointed to by R1. 

Returns the addresses of the virtual 

control unit, and device blocks for a gi 

device to the caller. 

Pageable. 

Prints and punches the respective 

separators on real spooling devices. 



e caller 

channel, 
ven real 

(in cuu 
channel 
virtual 

to the 

a device 
the one 

channel, 
ven real 



output 



Pageable but locked. 

Analyzes 2870 channel logout and sets appropriate 
bits in the ECSW field according to the results 
of analysis. It moves the channel logout to the 
check record. 

Pageable but locked. 

Analyzes 2860 channel logout and sets appropriate 
bits in the ECSW field according to the results 
of analysis. It moves the channel logout to the 
check record. 

Pageable. 

Save a page-form version of a 3704/3705 network 
control program. The name of the network control 
program and the DASD location at which it is to 
be saved is defined in the CP module DHKSYS. 



1-248 IBM VM/370 Systeai Logic and Problem Deteraination — Volume 1 



CP Module Entry Point Directory 



Module 
Name 



Entry 
Points 



Attributes, Function 



DMKSNT 



DMKSPL 



DMKSSP 



DMKSSS 



DMKSHTBL 



DMKSPLCR 
DMKSPLCV 
DMKSPLDL 
DMKSPLOR 
DMKSPLOV 



DMKSSP01 



DMKSSSL1 

DMKSSSL2 

DHKSSSL3 

DMKSSSHV 
DMKSSSI1 

DMKSSSI2 

DMKSSSUS 
DMKSSSVA 

DMKSSSLN 

DMKSSSCF 

DMKSSSDE 



Pageable. 

This module is assembled by the installation 
system programmer. It describes the system to be 
saved via the SAVESYS command and to be initial 
program loaded by name. Shared segments may be 
specified. These segments consist of all 
reenterable code and no altering of this storage 
is allowed. There is no executable code in this 
module. 

Pageable, 

Spool file manager. 

Closes and queues a real reader spool file for 

virtual input. 

Closes and queues a virtual printer or punch 

spool file for processing. 

Deletes used files from the system and 

de-allocates the DASD page space. 

Initializes control blocks and buffers for real 

input reader files* 

Initializes control blocks and buffers for 

virtual printer and punch output spool files. 

This module is found in the starter system only. 
It builds RCHBLOKs, RCUBLOKs, and RDEVBLOKs 
necessary to configure a minimum CP system. From 
the starter system, a real CP system figured 
based on the REALIO deck of the installation. 
Entered as a result of an IPL operation. 
Constructs the I/O blocks and system modules for 
a minimum system configuration. 

Resident. 

Services routines for all other modules that 

require access to the MSS. 

Processes a DEDICATE statement 

parameter. 

Processes a DEDICATE statement 

volid specified, and the raddr is 



with the 3330V 



with raddr 
a 3330V. 



and 



DEDICATE statement with a volid but 



that had previously 

has just caused a 
missing attention 



Processes a 

no raddr. 

Processes DIAGNOSE code X»78« 

Reschedules an I/O operation 

caused a cylinder fault. 

Queues an I/O request that 

cylinder fault. sets the 

handler timer interruption value. 

Quiesces all MSS mount and demount activity. 

Attaches a 3330V to the system or to a virtual 

machine. 

Allocates a 3330V device and mounts the required 

3330V system volume. 

Resets a virtual device defined on a 33307, 

including purging any I/O waiting for an MSS 

volume mount. 

Demounts an MSS volume from a 3330V. 
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Module 
Name 



Entry 
Points 



Attributes, Function 



DMKSTK 



DMKSVC 



DMKSYM 



DMKSYS 



DMKTAP 



DMKTBL 



DMKTBM 



DMKSSSEN 
DMKSSSMQ 



DMKSTKCP 
DMKSTKDE 
DMKSTKIO 
DMKSTKLF 

DMKSTKMP 
DMKSTKOP 



DMKSVCIN 



DMKSYM 



DMKSYS 



DMKTAP 



DMKTAPER 
DMKTAPRL 

DMKTBL 

DMKTBMMO 

DMKTBMNI 
DMKTBMNO 
DMKTBMZI 
DMKTBMZO 



Returns to the appropriate requesting routine 

after an MSS volume mount is complete. 

Serves as the anchor for the MSSCOM control 

blocks that are queued for MSS mounts, demounts, 

and pack change interruptions. 

Does not contain executable code. 

Resident. 

Stacks I/O blocks. 

Stacks a CPEXBLOK. 

Stacks a deferred execution block. 

Stacks an IOBLOK. 

Stacks a CPEXELOK LIFO (used by EXTEND and 

machine check) . 

Stacks CPEXBLOK for current processor only. 

Stacks CPEXBLOK for the other processor only. 

Resident. 

Handles any SVC interrupt. 

Pageable. 

Provides a symbol table of all CSECTS and entry 

points. 

Resident. 

Exists as a CSECT that defines the system 

residence volume, paging space, operator ID, dump 

ID, storage size, and time zone. 



Pageable. 

Examines the error cond 
unit check while executi 
channel program. Positi 
required on read/write c 
program is reexecuted. If 
uncorrectable, a call is 
writer (DMKMSW) to noti 
regaining control from 
channel program may be re 
Retries the failing tape 
tape positioning command 
Performs tape release 
four-channel switch capab 



ition resulting from a 

ng a CP generated tape 

oning of the tape is 

ommands and the channel 
the error condition is 
issued to the message 

fy the operator. Upon 
DMKMSW, the original 

executed or terminated. 

channel program, after a 

has been executed. 

to determine two- or 

ility. 



Resident. 

Contains the terminal translate tables. 

Pageable. 

Contains terminal translate tables for APL. 
EBCDIC to APL correspondence terminal code, 
correspondence terminal code to APL. 
APL PTTC/EBCD terminal code to EBCDIC. 
EBCDIC to APL PTTC/EBCD terminal code. 
3270 APL compound read translation. 
3270 APL compound write translation. 



APL 
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Module 
Name 



Entry 
Points 



Attributes, Function 



DMKTCS 



DHK'TDK 



DMKTHI 



DMKTMR 



DMKTRA 



DMKTRC 



DMKTRD 



DMKTCSET 
DMKTCSSP 
DMKTCSCO 



DMKTDKGT 
DMKTDKRL 



DMKTHIEN 



DMKTMRCC 

DMKTMRCK 
DMKTMRPT 
DMKTMRSP 

DMKTMRTN 
DMKTMRYT 



nwrtpq nftr 



DMKTRCEX 
DMKTRCIO 
DMKTRCIT 
DMKTRCND 
DMKTRCPB 
DMKTRCPG 
DMKTRCPV 
DMKTRCSY 

DMKTRCSW 



DMKTRDSI 
DMKTRDWT 



Pageable. 

Sets up the 3800 prior to printing the file. 
Sets up the 3800 prior to printing the separator. 
Sets up the forms overlay sequence control. 

Pageable. 

Allocates cylinders of temporary disk space from 

owned volumes. 

Releases temporary disk space to the pool of free 

space. 

Pageable. 

Displays data about use of and contention for 

major system resources. 

Processes INDICATE command. 



Resident. 

Simulates the CPU time 
comparator instructions 
operating in EC mode. 
Entered after expanded 
processing of a virtual 
Simulates virtual clock 
Calculates user*s total 
Entered after expanded 
processing of a virtual 
Simulates timer instruct 
Simulates virtual CPU ti 



r and time-of-day clock 
for virtual machines 

virtual machine assist 
SCKC instruction, 
comparator interruptions, 
virtual problem time. 

virtual machine assist 
SPT instruction, 
ion. 
mer interruptions. 



Pageable. 

Processes the TRACE command line. Provides a 

virtual machine with facility to track SVC 

instructions, program interrupts, external 

interrupts, successful searches, or all 

instructions with output on the printer or 

terminal. 

TRACE command processor* 

Pageable. 

Processes the TRACE command functions. 

Traces external interruptions. 

Traces I/O interruptions. 

Sets the needed SVC B2 for instruction tracing. 

Ends tracing. 

Puts back user instructions altered by tracing. 

Traces program interruptions. 

Traces privileged instruction interruptions. 

Processes an SVC, Branch, or full instruction 

TRACE. 

Traces virtual and real CSHs. 

Pageable. Split from DMKTRC. 

Traces I/O operations (SIO, TIO, HIO, TCH) . 

Serialization entry for I/O and CCW tracing. 
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Module 
Name 



Entry 
Point* 



Attributes, Function 



DMKTRM | | Pageable. 

DMKTRMID I Identifies a 2741 terminal as either a 2741P 
(PTTC/EBCD) or 2741C (correspondence) from the 
user command. It sets ADEVTYPE the RDEVBLOK to 
TYP2741P or TYP2741C and sets flag RDEVIDNT on if 
the terminal was successfully identified. 

DMKDCB I | Pageable. 

DMKUCB I Contains the DCB buffer load images used by the 
LOAD command to load the universal character set 
buffer in the 3811 control unit. This module 
contains no executable code. 

DMKOCC | | Pageable. 

DMKOCCLD | Contains the OCB buffer load images used by the 
LOAD command to load the universal character set 
buffer in the 3203 printer control unit. This 
module does not contain executable code. 

DMKUCS | | Pageable. 

Contains the DCS buffer load images that the LOAD 
command uses to load the universal character set 
buffer in the 2821 control unit. This module does 
not contain executable code. 

DMKUDR | | Pageable. 

DMKDDRB? I Allows the DMKDIRCT or DHKCPINT programs to build 

a list of virtual page buffers; one for each 

DDIRBLOK page on disk. 
DMKODRDS I Allows the DMKDIRCT program to swap the active 

user directory to the newly created user 

directory. 
DMKODRFD | Puts specified UDEVBLOK into the caller's buffer. 
DMKODRFU I Finds a given user ID in the user directory and 

moves the user's directory entry into the 

caller's buffer. 
DMKUDRRD | Reads the next user directory into the caller's 

buffer. 
DMKUDRR? | Releases a virtual page used by the directory 

program as a buffer. 

DMKUDU | | Pageable. 

DMKDDOMN I Updates in-place the CP directory on the object 
DASD page and updates in-place the virtual system 
page (if used) on the paging device. Entered 
from DMKHVD when a class B virtual machine issues 
a DIAGNOSE code '84' instruction. 

DMKUNT | | Resident. 

Ontranslates CCWs and CSHs. 

DMKONTFR | Releases pages and free storage used for the CCW 
chain. Also processes the CP assist instruction, 
UNTFR (E605) . 

DMKUNTIS | Finds the RCWTASKS that have been patched to 
handle OS ISAM self-modifying seguences and put 
them back the way DHKCCW had them to allow 
DMKONTRN and DMKONTFR to operate correctly. 
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Module 
Name 



Entry 
Points 



Attributes, Function 



DMKDSO 



DMKVAT 



DMKVCA 



DMKDNTRN 



DMKDNTRS 



DMKDSODS 
DHKUSOFF 
DMKOSOFL 
DMKUSOFM 



DMKUSOLG 

DMKVATAB 

DMKVATBC 
DMKVATEX 

DMKVATLA 
DMKVATMD 
DMKVATPF 

DMKVATPX 

DMKVATRN 

DMKVATSX 

DMKVATZP 

DMKVATZS 



DMKVCARD 



DMKVCARS 



Translates a real CSW into 
processes the CP assist 
(E610) . 



a virtual CSW. Also 
instruction, OHTRH 



Relocates sense byte information. For a 3330, 
3340, 3350, or 2305, computes virtual cylinder 
member in bytes 5 and 6 of the sense byte data by 
unrelocating the real cylinder number given by 
the hardware. For a 2311 simulated on a 2314 or 
2319, computes the appropriate status for byte 3 
of the sense data from the real sense data given 
by the hardware. 

Pageable. 

Processes user termination. 

Processes the DISCONN (disconnect) command. 

Logs off a user. 

Processes the FORCE command. 

Returns subpools from the free storage chain and 

removes spool file blocks and allocation blocks 

from the dynamic paging area. 

Processes the LOGOFF command. 

Resident. 

Storage management for EC mode virtual machine. 

Allocates, initializes and maintains shadow, 

segment, and page tables for virtual machines 

that can relocate. 

Returns active shadow tables to free storage. 

Services page or segment exceptions for virtual 

EC machines. 

Virtual - virtual to virtual address translation. 

Allocates and initializes shadow tables. 

Handles pseudo page fault interruption from a VS1 

virtual machine. 

Processes paging exceptions for a virtual machine 

that performs paging. 

Virtual (shadow) — virtual-to-real address 

translation. 

Processes segment exception for a virtual machine 

that performs paging. 

Processes the CP assist instruction, ZAPPAGE 

(E60B) . 

Processes the CP assist instruction, ZAPSEGS 

(E60A) . 

Pageable. 

Simulates I/O for a virtual channel-to-channel 

adapter. 

Selectively resets a device for a virtual 

channel-to-channel adapter without decoupling the 

CTCA from the Y-side adapter. 

Does a final reset for a virtual 

channel-to-channel adapter and and disconnects 

the adapter from its coupled twin on the Y-side 

virtual machine. 
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t r 

Entry 
Points 



Module 
Name 



Attributes, Function 



DMKVCH 



DMKVCN 



DMKVDA 



DHKVDC 



DMKVDD 



DMKVDE 



DMKVDR 



DMKVDS 



DMKVER 



DMKVCASH 



DMKVCAST 



DMKVCATS 



DMKVCHDC 



DMKVCNEX 



DMKVDAAT 



DMKVDCAL 
DMKVDCPS 
DHK?DCSC 

DMKVDDDE 
DMKVDEDC 

DMKVDREL 



DMKVDSAT 
DMKVDSDF 
DMKVDSLK 



DMKVERD 
DMKVERO 



Simulates the execution of a HALT I/O or HALT 
DEVICE instruction for a virtual machine 
channel-to-channel adapter. 

Simulates the channel and device operations of 
the channel-to-channel adapter (CTCA) connected 
between two virtual machines under VM/370. 
Simulates the TEST I/O instruction for a virtual 
channel-to-channel adapter that has no 
interruptions pending. 



Pageable. 

Processes the ATTACH and 

channels) command. 



DETACH real devices and 



Resident. 

Simulates all SIOs to a virtual console. 

Pageable. 

Handles the ATTACH command. Attaches a real 
device to a user as a virtual device, or 
dedicates all devices on a particular channel to 
a specified user. 

Pageable. 

Chains RDEVBLOKs off the allocation chain 

anchors. 

Acquires virtual blocks for devices that are 

likely to be attached by the ATTACH command. 

Scans the ATTACH and DETACH command lines and 

checks syntax. 

Pageable. 

Handles the DETACH command. 

Pageable. 

Verifies the existence of a device specified on 

an ATTACH command. 

Pageable. 

Releases a virtual or real device from a virtual 

user. 

Pageable. 

Attaches a virtual device to a user. 
Defines a new virtual device for user. 
Links a virtual DASD device to a user. 

Pageable. 

Processes error records from virtual machine via 

SVC 76. 

Processes SVC 76 from DOS or DOS/VS. 

Processes SVC 76 from OS, VS/1, VS/2, or VM/370. 
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Module 
Name 



Entry 
Points 



Attributes, Function 



DMKVMA 



DMK7I0C1 
DMKVIOIN 
DMKVIOMK 



DMKVMASH 



DMKVMASW 



DMKVMCFC 



DMKVMCEX 



DMKVIO | | Resident. 

S ! Records and translates the interrupts and status 

associated with virtual I/O operations. 
Reflects condition code 1 CSW status. 
Translate a virtual I/O interruption. 
Address of a table of interruption masks, 
indexable by device address. 

Resident. 

Checks all protected shared pages associated with 

shared named systems and determines if they have 

been changed. If they were changed, the page is 

returned to CP free storage and the condition 

code is made nonzero. 

Switches the user's segment table entries from 

one protected shared page table to the other. 

DMKVMC | | Pageable. 

Main entry for all VMCF subf unctions. Called by 
DMKHVC when a DIAGNOSE X s 0068' instruction is 
executed. Builds a VMCBLOK with information from 
user-supplied parameter list, validates the 
subfunction code, and passes control to 
appropriate VMCF subroutine. 

Called by DMKDSP to reflect the VMCF external 
interrupt message header and optional SENDX data 
to a virtual machine. Copies the message header 
from the VMCBLOK to the user's external interrupt 
buffer. If interrupt is for a SENDX request, move 
SENDX data to the optional area in the external 
interrupt buffer. 

Branched to from the DMKVMCFC entry point or 
called by DMKCFP during a system reset. Releases 
the master VMCBLOK and any final response 
VMCBLOKs (VMCRESP bit) . Returns other VMCELOKs to 
the original SOURCE users with the notification 
that this user is not available. 

Pageable. 

Loaded into the user's virtual storage when 
invoked. Performs an IPL of a virtual machine. 
Simulates a user's IPL sequence. 

Resident. 

Simulates the operation of privileged I/O 
instructions issued by virtual machines. 
Simulates a SIO, TIO, HIO, TCH, or CLCH . 
Scans a V=R channel program for exceptional 
conditions, such as sense commands, no-ops, I/O 
to and from page 0, etc., without actually 
translating the program. 
LMK7SP I | Resident. 

Simulates all user SlOs to a virtual unit record 
device (real reader, punch, print, or pseudo 
timer that is spooled rather than dedicated. It 
also handles control program requests to print on 
the user's virtual printer. 



DMKVMCVA 



DMKVMI 



DMKVSI 



DMKVMIPL 



DMKVSIEX 
DMKVSISC 
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| Module 


Entry | 


i Name 


Points | 


t 


DMKVSPCO | 




DMKVSPCP | 




DMKVSPCR | 




DMKVSPEX | 




DMKVSPRT | 




DMKVSPTO | 




DMK7SPVP | 




DMKVSPWA | 


| DMKWRM 






DMKWRMST | 



Attributes, Function 



Stops processing the file currently in the 

spooled printer or punch and clears all pending 

status from the spooled printer or punch. 

Writes a print line to the console. 

Stopsv processing the file currently in the 

spooled card reader and clears all pending status 

from the spooled card reader. 

Simulates SIO to a spooled unit record device. 

Puts a CP-generated line on the user's spooled 

printer. 

Checks if the virtual reader is empty. 

Simulates SIO to a spooled virtual console. 

Nonexecutable index work area for 2311. 



Pageable. 

Warm start processing. Retrieves the system log 
messages, accounting cards, spool file blocks, 
and spooling allocation records from the warm 
start cylinder on the IPL pack. 
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MODOLE EXTERNAL REFE1 


FENCES (LABELS AND 


MODULES) 






















DMKACO ACCTBLOK 


ACCTOSER 


ACNTBACK 


ACNTBLOK 


ACNTCCH 


ACNTCODE 


ACNTCCNT 


ACNTDATA 


ACNTDEVC 


ACNTIOCT 


ACNTNCYL 


ACNTNEXT 


ACNTNUM 






ACNTPGRD 


ACNTSIZE 


ACNTSTOP 


ACNTTIME 


ACNTDSER 


ACNTVTIM 


ACOACCL 


ACOACCM 


ACOCHK 


ACOEXIT 


ACORETBL 


ACORETN 


ADSPCH 






AEXTSP 


AFREE 


AFRET 


ALARM 


APSTAT1 


APTRLK 


APUOPER 


AQCNHT 


ARIODV 


ARIOPU 


ARSPAC 


ASYSLC 


ASYSVM 






CC 


CLASDASD 


CLASGRAF 


CLASTERM 


CORCP 


CORFLAG 


CORTABLE 


CPEXADD 


CPEXELOK 


CPEXSIZE 


DATE 


DE 


DEVCARD 






DFRET 


DISPMSG 


DMKCVTAB 


DMKCVTBH 


DMKDSPCH 


DMKERMSG 


DMKFREE 


DMKFRET 


DMKIOSQR 


DMKLOKSN 


DMKPTRLK 


DMKPTRUL 


DMKQCNRD 






DMKQCNHT 


DMKRSPEX 


DMKSCHDL 


DMKSTKCP 


DMKSTKIO 


DMKSYSCK 


DMKTMBPT 


FTROPHDR 


F1 


FU 


FU095 


F60 


F8 






INHIBIT 


IOBCAH 


IOBCP 


IOBCSH 


IOBFATAL 


IOBFLAG 


IOBIRA 


IOBLINK 


IOBLOK 


IOBMISC 


IOBMISC2 


IOBRADD 


IOBSIZE 






IOBSPEC 


IOBSTAT 


IOBUSER 


IPUADDRX 


LOCGRAF 


LOCK 


NICBLOK 


NICOPRDR 


NICSIZE 


NICTYPE 


NORET 


PRIORITY 


PROCIO 






PSA 


RDEVACNT 


RDEVBLOK 


RDEVBUSY 


RDE7CLAS 


RDEVDED 


RDEVDIS& 


RDEVDRAN 


RDEVFLAG 


RDEVFTR 


RDEVMDL 


RDEVNICL 


RDEVSPL 






RDEVSTAT 


RDEVTMAT 


RDEVTYPC 


RDEVTYPE 


RO 


R1 


R10 


R11 


R12 


R13 


R1U 


R15 


R2 






R3 


RU 


R5 


R6 


R7 


R8 


R9 


SAVEAREA 


SAVEREGS 


SAVER11 


SAVER2 


SAVEHRK1 


SAVEHRK2 






SAVEHRK3 


SAVEHRK6 


SAVEHRK7 


SAVEHRK8 


SAVEHRK9 


SETUP 


SETUP1 


SETUP2 


SIGEMS 


SIGQUI 


SIGRES 


SIGXC 


SILI 


O 




SKIP 


START 


STCODE 


STOP 


SXSLOCS 


TIMEDISP 


TODATE 


TYPBSC 


TYP2540P 


TYP3277 


USERCARD 


VDEVBLOK 


VDEVBND 


V 




VDEVFLAG 


VDEVREAL 


VDEVTDSK 


VDEVTMAT 


VDEVTYPC 


VMACNT 


VMACOONT 


VMAPTIME 


VMBLOK 


VMCFHAIT 


VMCPTIME 


VMCRDS 


VMDSTAT 




VMEXHAIT 


VMIDLE 


VBINQ 


VMIOCNT 


VMLINS 


VMLOGOFF 


VMLONGNT 


VMNORUN 


VMPGREAD 


VMPGHRIT 


VMPNCH 


VMRSTAT 


VMTERM 


2 

o 




VMTIMEON 


VMTMINQ 


VMTRMID 


VMTTIME 


VMOSER 


VMVTIME 


ZEROES 
















DHKALG ADSPCH 


AFREE 


APSTAT1 


APOOPER 


EUFCNT 


BUFFER 


BUFNXT 


BUFSIZE 


CPEXADE 


CPEXBLOK 


CPEXRO 


CPEXR12 


CPEXSIZE 


a 




DMKBLDVM 


DMKERMSG 


DMKFREE 


DHKLOGB 


DMKLOKSN 


DMKSCHDL 


DMKSCSVD 


DMKSTKCP 


DMKSYSJR 


F1 


F240 


JPSCBLOK 


JPSLOGDS 


c 




LOCK 


LOGONJRL 


PSA 


RO 


H1 


R10 


R11 


R12 


H13 


R14 


R15 


R2 


R3 


© 




Rlt 


R7 


R8 


R9 


SAVEAREA 


SAVEREGS 


SAVER11 


SAVER2 


SAVER9 


SAVEHRK1 


SAVEHRK8 


TIMEDISP 


VCONCTL 




VCONRBSZ 


VCONRBUF 


VCONRCNT 


VDEVAUCR 


VLEVBLOK 


VDEVCFLG 
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CPEXMISC 


CPEXREGS 


CPEXRO 


CPEXR1 


CPEXR11 


CPEXR12 


CPEXR3 


CPEXSIZE 


C1 


DEFEB 


DEMOUNT 


DMKC7TBH 


DMKDSPCH 


IDNKERMSG 


DMKFREE 


DMKFRET 


DMKLNKSS 


DMKLOGSS 


DMKPTRAN 


DMKSCHRT 


DMKSCHST 


DMKSCNAU 


DMKSCNBU 


DMKSCN7S 


DMKSCN7U 


DMKSTKCP 


DMK7DAS1 


DHKVDAS2 


DMK7I0MK 


F1 


IOBBPNT 


IOBCYL 


IOBFLT 


IOBFPHT 


ICBLOK 


IOBBAEB 


I0BRS73 


IOBSIZE 


IOBSTAT 


I0B7ADD 


LOCK 


MOUNT 


NSSERR 


MSSFLAGS 


MSSNEXT 


MSSPRES 


MSSRSB7D 


MSSSER 


MSSSIZE 


MS ST AS K1 


MSSTASK2 


MSSUSER 


IMSS7UA 


PSA 


PSAMSS 


RCHADD 


RCHBLOK 


RCUADD 


RCUBLOK 


RCUCHA 


RCUPRIME 


RCUSUB 


RCUTYPE 


REE7ADD 


RDE7ATT 


IRDE7BL0K 


RDE7CDA 


RDEVDED 


RDE7DISA 


RDE7FI0B 


RDE7FLAG 


RDEVFTR 


RDE7LNKS 


RDE7M0UT 


RDE7CWN 


RDE7SEL 


RDE7SER 


RDE7SIZE 


RDE7STAT 


RDE7SYS 


RDEVTYPC 


RDE7TYPE 


RDE7USER 
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R11 
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R3 
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R5 


R6 


R7 


R8 


R9 


SA7EAREA 


SA7EREGS 


SA7ERETN 


S A7 ER 1 


SA7ER12 


SA7ER2 


SA7EWRK1 


SAVEWRK2 


SA7EWRK3 


SA7EWRK4 


SA7EWRK5 


SA7EWRK6 


SA7EWBK7 


SA7EWRK8 


SYS7IRT 


TEMPS A7E 


TRQBIRA 


TRQBLOK 


TRQBSIZE 


TRQBTOD 


TRQBUSER 


TRQB7AL 


TYP3330 


UEE7ADD 


UDE7BL0K 


UDE7LINK 


UDE77SER 


7CHAED 


7CHBL0K 


VCHCUINT 


7CUADD 


7CUBL0K 


7CUD7INT 


7DE7ADD 


7DE7BL0K 


7DE7BND 


7EE7BUSY 


7DE7INTS 


VDEVPEND 


7DE7RELN 


7DE7STAT 


7IRTUAL 


7MBL0K 


7HGPRS 


7MI0INT 


VMIOPND 


7MPEND 


7MPSW 


7MSEG 


7MUSER 


ZEROES 
















DMKSTK ALOKSP 


APSTAT1 


APUOPER 


CPEXBLOK 


CPEXDEFR 


CPEXMISC 


CPEXPRIO 


CPEXPROC 


CPEXR11 


CPEXTYPE 


DHKDSPRQ 


DMKLOKDS 


F1 


IOBFPNT 


IOBLOK 


IOBUSER 


LOCK 
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PSA 


HO 
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R11 
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R15 


R2 


R3 


R4 


R5 


R6 


SWTHSA7E 
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VMBLOK 


7MDEFSTK 


VMPEND 


7MPRRCT 


7MSTKCNT 
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AFREE 
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APAGCP 


APSTAT1 


APTRAN 


APTRLK 


APUOPER 


AQCNWT 


ASYSVM 


BRING 


CODE 
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CPCREG8 


CPEXADD 


CPEXBLOK 


CPEXLPSW 


CPEXREGS 


CPEXR12 


CPEXSIZE 


CPEXTYPE 


CPRUN 


CPSTATUS 


CPSUPER 


CO 


C1 


C8 


DEFER 


DFRET 


DMKCFMBK 


DMKC7TBH 


DMKDMPDK 


DMKDSPB 


DMKDSPCH 


DMKDSPRU 


DMKFREE 


DMKFRET 


DMKLOKDF 


DMKLOKSY 


DMKPRGRF 


DMKPTRAN 


DMKPTRUL 


DHKQCNHT 


DMKSTKDE 


DMKSTKS1 


DMKTRCIT 


DMKTHCPB 


DNKTBCS7 


DMKVERD 


DMK7ER0 


DUMPSA7E 


ECBLOK 


EXTCR8 


EXTMASK 


EXTMODE 


FFS 


F4095 


F60 


INTS7C 


INTS7CL 


IOERETN 


IOMASK 


LOCK 


LPUADDR 


MCHEK 


NORET 


PREFIXA 


PROBHODE 


PSA 


PSACPXBP 


PSAS7CCT 


QUANTUM 


QUANTUMR 


RUNCRO 


RUNPSW 


RUNUSER 


RO 


R1 
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R5 


R6 


R7 


R8 


SATEAREA 
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SA7ESIZE 


SAVEWRK2 


START 


STOP 


S7CNPSW 


S7C0PSW 


S7CREGS 


SYSTEM 


TIMEDISP 


TIMER 


TRACCUBR 


TRACEND 


TRACFLG1 


TRACPROC 


TRACSTRT 


TRAC02 


TRANHODE 


TRCS7C 


TREXIN1 


TREXT 


TYPE 


7MADST0P 


7MBL0K 


VMDFTENT 


7MECEXT 


VHESTAT 


7MEXTCM 


VMEXWAIT 


7MFPRS 


7MGPRS 


7MINST 


7MMCR6 


7NMICS7C 


7MMS7C 


7MPEND 


7MPERPND 


7MPSTAT 


7MPSW 


7MRSTAT 


7 MS EG 


VMTMOUTQ 


7HTRBRIN 


7MTRCTL 


7MTREXT 


7HTRS7C 


7M7 370R 


WAIT 
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DMKSIM DMKACO 


DNKALG 


DMKAPI 


DBKATS 


DMKBLD 


DMKBOX 


DBKBSCER 


DBKCCHIS 


DBKCCHHT 


DMKCCHRT 


DMKCCB60 


DMKCCWSB 


DMKCCWTC 


DMKCCHTR 


DMKCDB 


DMKCDBDC 


DMKCDM 


DMKCDS 


DBKCFC 


DHKCFD 


DBKCFDAD 


DBKCFG 


DMKCFB 


DMKCFBAT 


DMKCFMBK 


DMKCFMEN 


DMKCFOEX 


DMKCFP 


DMKCFPRD 


DHKCFSET 


DBKCFT 


DHKCKPT 


DBKCKS 


DBKCLK 


DBKCNSED 


DMKCNSEN 


DMKCNSIC 


DMKCNSIN 


DflKCPB 


DMKCPEID 


DMKCPEML 


DMKCPEND 


DMKCPI 


DBKCPS 


DMKCPSH 


DBKCPD 


DBKCPDDP 


DMKCPOVY 


DMKCPV 


DMKCQG 


DMKCQP 


DMKCQR 


DMKCQY 


DMKCSB 


DMKCSO 


DMKCSP 


DBKCSQ 


DMKCST 


DBKCSO 


DBKCSV 


DBKCSVTR 


DBKDASER 


DHKDGDDK 


DMKDIA 


DBKDIB 


DMKDMPDK 


DMKDRD 


DMKDSBRD 


DMKDSBSD 


DBKDSPA 


DMKDSPAC 


DHKDSEB 


DMKDSPBC 


DBKDSPCC 


DMKDSPCH 


DBKDSPE 


DMKDSPEC 


DBKDSPNP 


DMKDSPQS 


DMKDSPRC 


DMKDSPRQ 


DMKDSPRD 


DBKEBA 


DMKEHB 


DBKEBC 


DMKERfl 


DBKEXTSL 


DMKEXTSP 


DBKFCB 


DMKFREE 


DMKFREHI 


DMKFRELG 


DMKFRELO 


DMKFRELS 


DMKFRENP 


DMKFRERC 


DMKFRERS 


DBKFRESV 


DBKFRET 


DBKFRETR 


DMKGIO 


DBKGRFEN 


DMKGRFIC 


DMKGRFIN 


DMKGRFTI 


DMKHVCAL 


DBKHVCDI 


DMKHVD 


DBKIOC 


DBKIOEFM 


DBKIOERR 


DBKIOF 


DMKIOG 


DMKIOSHA 


DMKIOSIN 


DMKIOSMQ 


DMKIOSQR 


DMKIOSQV 


DMKISM 


DMKLNK 


DMKLNKSB 


EHKLOC 


DMKLOG 


DBKLOGOP 


DMKLOHON 


DBKLCKCT 


DMKLOKDF 


DMKLOKDS 


DMKLOKFR 


DMKLOKPS 


DMKLOKRL 


DHKLOKSP 


DMKLOKSW 


DMKLOKSY 


DBKLOKTR 


DMKLOKVM 


DBKBCC 


DBKBCHIN 


DMKBCHBS 


DMKMCHSE 


DMKBCHST 


DMKMCTHA 


DMKMCTPR 


DMKMCTPT 


DMKMCTST 


DMKMIDNT 


DMKMNI 


DBKBON 


DMKHSG 


DBKBSHR 


DBKNEM 


DBKNES 


DBKNET 


DMKNLE 


DMKOPRUT 


DMKPAGIO 


DMKPAGPS 


DMKPAGST 


DMKPER 


DMKPGS 


DBKPGSPO 


DHKPGSPP 


DBKPGTBN 


DBKPGTPG 


DBKPGTTM 


DMKPGTTD 


DMKPRGCT 


DMKPRGC8 


DBKPRGIN 


DMKPRGMC 


DMRPRGRF 


DBKPRGSM 


DMKPRVLG 


EBKPRVNC 


DMKPSADU 


DBKPSAEX 


DMKPTRAN 


DBKETBCT 


DMKPTRFC 


DBKPTRFF 


DMKPTRPR 


DBKPTRRC 


DMKPTRRQ 


DMKPTRSC 


DMKPTRSS 


DMKPTRWQ 


DBKQCNCL 


DMKQCNET 


DBKQCFRD 


DBKQCNSY 


DBKQCNTO 


DMKQCNWT 


DBKRGAIN 


DMKRGBEN 


DBKRGBIC 


DMKRIOCH 


DMKRIOCN 


DMKRIOCO 


DBKRIODV 


DBKRIOPR 


DMKRIOPD 


DMKRICRD 


DBKRIORN 


DMKRFHCT 


DMKBNHIC 


DBKRNHIN 


DMKRNHND 


DBKRNHTG 


DMKRNHTR 


DMKRPAGT 


DBKRPAPT 


DMKRSE 


DBKRSPAC 


DMKRSPCV 


DBKRSPDL 


DBKRSPER 


DBKRSPEX 


DMKRSPHQ 


DBKRSPID 


DMKRSPPR 


DMKRSPPD 


DMKRSPRD 


DMKRSPOR 


DMKRSP83 


DMKSCHAE 


DBKSCHAL 


DBKSCHAP 


DBKSCHAD 


DBKSCHCP 


DBKSCHCT 


DMKSCHDL 


DMKSCHIB 


DMKSCHMD 


DBKSCHN1 


DMKSCHN2 


DMKSCHPB 


DMKSCHPD 


DMKSCHPG 


DBKSCHPD 


DKKSCHQ1 


DBKSCHQ2 


DBKSCHHL 


DBKSCBRT 


DBKSCHST 


DBKSCHTI 


DMKSCHTQ 


DMKSCHDB 


DMKSCHW1 


DMKSCHW2 


DMKSCH80 


DMKSEP 


DBKSEV70 


DMKSIX60 


DBKSPL 


DHKSTKCP 


DBKSTKEB 


DMKSTKIO 


DBKSTKLF 


DMKSTKMP 


DMKSTKOP 


DMKSVCIN 


DMKSTSCS 


DMKSYSLC 


DMKSYSOC 


DMKSYSOP 


DBKSYSOW 


DBKSYSRM 


DBKSYSRS 


DBKSYSFV 


DBKSYSVL 


DBKSYSVM 


DMKTAPER 


DMKTBL 


DMKTBM 


DMKTCS 


DMKTDK 


DMKTHI 


DBKTMRTN 


DMKTRA 


DBKTRKFP 


DBKTRKIN 


DBKTHKVA 


DMKTRM 


DBKDCB 


DMKDCC 


DBKUCS 


DMKODR 


DMKDDRDS 


DMKDNTFR 


DMKONTIS 


DBKDNTRN 


DBKDNTRS 


DMKDSC 


DHKVATAB 


DBKVATBC 


DMKVATEX 


DBKVATLA 


DBKVATBD 


DMKVATPX 


DMKVATRN 


DMKVATSX 


DMK7CA 


DBKVCH 


DBKVCNEX 


DMKVCNFT 


DBKVDA 


DHKVDC 


DBKVEE 


DMKVDE 


DBKVDR 


DMKVER 


DMKVIOIN 


DMKVMASH 


DMKVMC 


DMKVMI 


DMKVSICT 


DBKVSICU 


DBKVSIEX 


DBKVSFCO 


DBKVSPCP 


DHKVSPCH 


DMKVSPEX 


DMKVSPRT 


DMKVSPTO 


DMKVSPVP 


DBKVSPWA 


DMKVSQPD 


DMKWRM 


LOCK 




















DMKTAP ADSPCH 


A FREE 
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ASYSVB 
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CCC 


CD 


CEC 
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CPEXBLOK 


CPEXREGS 


CPEXRO 
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IOBCAW 
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IOBCSW 


IOBERP 


IOBFATAL 


IOBFLAG 
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IOBIRA 


ICBLINK 


IOELCK 


IOEMISC 


IOBRADD 


IOBRCAW 


IOBRCNT 


IOBRSTRT 


IOBSIZE 


IOBSPEC 


IOBSTAT 


IOBTIO 


IOBDNSL 


IOBDSER 


ICERACT 


IOERAER 


IOERBLOK 


IOERBSR 


IOERCAN 


IOERCCRA 


IOERCCRL 


IOERCLH 


IOERCSW 


IOERDATA 


IOERDN 


IOERERG 


IOEREXT 


ICERFLG1 


I0ERFLG2 


I0ERFLG3 


IOERFSR 


IOERIGNR 


I0ERIND3 


I0ERIND4 


IOERINFO 


IOERLOC 


IOERMSG 


IOERBSfl 


IOERNDB 


IOEROFA 


ICERPEND 


IOEHREK 


IOERREAD 


IOERREW 


IOERSIZE 


IOERSTRT 


I0ERS0PP 


IOERVLD 


IOERWRK 


LOCK 


NOP 


PRGC 


PROCIC 


PBTC 


PSA 


RDEVBLOK 


RDEVCUB 


RDEVFTR 


RDEVIOER 


RDEVNRDY 
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DMKTCS ADSPCH AFREE AFRET APSTAT1 APTRAN 

DHKCVTBD DMKCYTBH DMKDSPCH DMKERMSG DBKFREE 

DMKSCNAO DBKSCNRD DBKSCNVS FCBIO FTR4WCGM 

IOBFLAG IOBIRA IOBLINK IOBLOK IOBBISC 

NPRTBL NPRVOL PSA RDEVBLOK REEVCODE 

RDEVSTA2 RDEVTYPE RDEVXSEP RSPDPAGE RSPLCTL 



APTRLK APDCPER ASYSVM BLANKS BRING CC C1 DEFER 

DBKFRET DBKIOSQB DBKLOKSW DBKPGTVG DBKPGTVR DBKPTRAN DBKQNTBL DBKRPAGT 

F1 F256 F3 F4095 F4096 IEA IOBCAW IOBFATAL 

I0BBISC2 IOBRSTRT ICBSIZE IOBSTAT LOCK NPRNABE NPRPNT NPRSTART 

RDEVCDRP RDEVEXTU RDEVFLAG RDEVFSEP RDEVFTR RDEVIMAG RDEVOWN RDEVPURG 

RSPRPAGE RSPRPAG2 FSPVPAGE RSPXELCK RSPXCHR RSPXCBOD RSPXCRWC RSPXFCB 



O 

as 
o 

Pi 

c 

H 
CD 
I 
r+ 



po 
tr 



n 

t-1 
O 
C/) 
H 

W 
CD 
H» 
CD 

CD 
» 
O 
CD 



MODULE 



EXTERNAL REFERENCES (LABELS AND MODULES) 



RO R1 H10 R11 R12 R13 R14 R15 R2 R3 RU R5 R6 

R7 R8 R9 SAVEAREA SAVEREGS SAVER11 SAVEWBK1 SAVEWRK2 SAVEWRK3 SAVEWRK4 SAVEWRK5 SAVEWRK6 SAVEWRK7 

SAVEWRK8 SAVEWRK9 SFBCOPY SFBFILID SFBLOK SFBSTART SFBSTCEX SFBUSER SILI SKIP SPCHAR SPCMOD SPCOPYFG 

SPFCB SPFLAG1 SPFLSHC SPLINK SYSTEM TIMEDISP TYP2314 TYP3330 TYP3350 VMBLOK VMSEG XPAGNUM ZEROES 

DMKTDK ADSPCH AFREE AFRET ALOCBLOK ALOCCYL1 ALOCCYL2 ALOCMAP ALOCPNT CC DMKDSPCH DMKFREE DMKFRET DMKIOSQR 

DMKPGTPO DMKPGTPU DMKPGTP5 DMKPGTTO DMKPGTT4 DMKPGTT5 DBKPGT4I? DBKPGT4T DMKPGT5P DMKPGT5T FTR70MB F255 F256 

IOBCP IOBCYL IOBFLAG IOBLOK IOBMISC LOCK PSA RDEVALLN RDEVELOK RDEVFTR RDEVLNKS RDEVPNT RDEVTYPE 

RO R1 R10 R11 R12 R13 R14 R15 R2 R3 R4 R5 R6 

R7 R8 R9 SAVEAREA SAVEREGS SAVERO SAVER1 SAVER8 SAVEWRK2 SEEK SILI TIC TYP2314 
TYP3330 TYP3340 TYP3350 
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VMCLASSA 

VMINQ 

VMPSHAIT 
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SAVEAREA 
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VMIOCNT 
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APUOPER 

DMKSCHCU 

FU 

R12 

SAVEREGS 
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VMQLEVEL 
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DMKSCHEL 

F60 

R13 

SAVER 11 

VMCLASSD 

VMLINS 

VMQ1 



ASYSVM 

DMKSCHLI 

F8 

R14 

SAVEWRK1 
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VMPAGES 

VMRSTAT 
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DMKSCHRL 
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R15 
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VMPDISK 

VMRUN 



DFRET 

DHKSCHSC 
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R2 

SAVEWRK3 
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R3 
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VMPINE 

VMTTIME 
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EMKSCNFD 
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R5 

VDEVELOK 
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VMPGHAIT 

VMWSPROJ 
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DMKSCNRD 
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R6 
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VMDSTAT 
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DMKTRA 



DMKTRC 



ADSPCH 

CPEXBLOK 

DMKLOKDF 

DMKVATRN 

F60 
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SAVE 

VMCPTIME 

VMPEND 

VMTMRINT 

AFREE 

DMKTRCIT 

RO 

SAVEREGS 

TREXPRNT 

VMPSW 

VMTRPER 



AFREE 

CPEXREGS 

DMKLOKSY 

ECBLOK 

F7 

R12 

TRANMODE 

VMCPUTMR 

VMPERCM 

VMTRCTL 

AFRET 

DMKTRCPB 

R1 

SAVER2 

TREXRUNF 

VMRON 

VMTRPRG 
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CPRUN 

DMKPRGSM 

EXTCCTRQ 

F8 

R13 

TREXCR9 

VMDFTPNT 

VMPERPND 

VMTREXT 



APSTAT1 

CPSTATUS 

DMKPSAFP 

EXTCPTMR 

LOCK 

R14 

TREXPERA 

VMDSP 

VMPRGIL 

VMTRPER 



AFRET APTRAN 
DMKFRET DMKLOCKD 
DMKVATRN DMKVSPRT 
IOBCSW IOBLOK 
R12 R13 
SAVEREGS SAVERO 



AQCNWT COUNT 
FFS FLAG1 
R11 R12 
SAVEHRK1 SAVEWRK2 
TREXSIZE TREXT 
VMRSTAT VMSEG 
VMTRPRV VMTRS.TO 

APTRLK AQCNWT 
DMKLOCKQ DMKNEMOP 
ECBLOK EXTCRO 
IOBRADD IOBVADD 
R14 R15 
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LOCKSAV 
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SAVEWRK7 
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BLANKS 
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EXTMASK 

IOMASK 
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LOCK NORET 
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DMKLOCKQ DMKQCNWT DMKSCNFD 
NORET PSA RUN 
R5 R9 SAVEAREA 
TREXCTL TREXINST TREXIN1 
VMMADER VMMCR6 VMMVTMR 
VMTREXT VMTRINT VMTRIO 



DMKPSASC DMKPSASP DMKPTRAN 



DMKATSCF DMKCFMBK DMKCVTBH 
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DHKCST 
DHKDRD 
DHKHVC 
DHKLOC 
DHKHSG 
DHKPRG 
DHKSAV 
DHKTAP 
DHKOHT 
DHKVER 
DHKAPI 
DHKCFH 
DHKCPS 
DHKCST 
DHKDRD 
DHKHVC 
DHKLOG 
DHKHSW 
DHKPRV 
DHKSCH 
DHKTCS 
DHK0S0 
DHKVIO 
DHKAPI 
DHKCFO 
DHKCQG 
DHKCVT 
DHKERH 
DHKJRL 
DHKHID 
DHKPGT 
DHKSAV 
DHKTDK 
DHKVCH 
DHKVHI 
DHKAPI 
DHKCFH 
DHKCPS 
DHKCST 
DHKDSB 
DHKIOC 
DHKHCD 
DHKHLD 
DHKRHD 



DHKCFH 

DBKCPO 

DHKCSD 

DHKDSB 

DHKHVD 

DHKLOG 

DHKHSW 

DHKPRV 

DHKSCH 

DHKTCS 

DHKOSO 

DHKVIO 

DHKATS 

DHKCFH 

DHKCPD 

DHKCSD 

DHKDSB 

DHKHVD 

DHKLOB 

DHKHEH 

DHKPSA 

DHKSCH 

DHKTDK 

DHKVAT 

DHKVHA 

DHKATS 

DHKCFP 

DHKCQH 

DHKDAS 

DHKFHT 

DHKLD00E 

DHKHHI 

DHKPRG 

DHKSCH 

DHKTHI 

DHKVCH 

DHKVSI 

DHKATS 

DHKCFH 

DHKCPD 

DHKCSD 

DHKDSP 

DHKIOE 

DHKHCH 

DHKHLE 

DHKRHH 



DHKCFO 
DHKCPV 
DHKCSV 
DHKDSP 
DHKIHG 
DHKLOH 
DHKHEH 
DHKPSA 
DHKSCH 
DHKTDK 
DHKVAT 
DHKVHA 
DHKBLD 
DHKCFO 
DHKCPV 
DHKCSV 
DHKDSP 
DHKIHG 
DHKLOK 
DHKHES 
DHKPTR 
DHKSEP 
DHKTHI 
DHKVCA 
DHKVHC 
DHKBLD 
DHKCFS 
DHKCQP 
DHKDDR 
DHKFRE 
DHKLHK 
DHKHOH 
DHKPRV 
DHKSCH 
DHKTHR 
DHKVDA 
DHKVSP 
DHKBLD 
DHKCFO 
DHKCPV 
DHKCSV 
DHKEHT 
DHKIOF 
DHKHCT 
DHKPAG 
DHKRPA 



DHKCFP 

DHKCQG 

DHKCV1 

DHKEIG 

DHKIOC 

DHKLOK 

DHKHES 

DHKPTB 

DHKSEF 

DHKTHI 

DHKVCA 

DHKVHC 

DHKBSC 

DHKCFD 

DHKCQG 

DHKCVT 

DHKEIG 

DHKIOE 

DHKHCC 

DHKHET 

DHKQCH 

DHKSEV 

DHKTHB 

DHKVCH 

DHKVHI 

DHKBSC 

DHKCFT 

DHKCQB 

DHKDEF 

DHKGIC 

DHKLOC 

DHKHSG 

DHKPSA 

DHKSEP 

DHKTRC 

DHKVDC 

DHKVSQ 

DHKBSC 

DHKCFP 

DHKCQG 

DHKDAS 

DHKERH 

DHKIOG 

DHKHIA 

DHKPGS 

DHKRSE 



DHKCFS 
DHKCQH 
DHKDAS 
DHKEHT 
DHKIOE 
DHKHCC 
DHKHET 
DHKQCH 
DHKSEV 
DHKTHR 
DHKVCH 
DHKVHI 
DHKCCB 
DHKCFS 
DHKCQH 
DHKDAS 
DHKEHT 
DHKIOF 
DHKHCD 
DHKHLD 
DHKRGA 
DHKSIX 
DHKTRA 
DHKVCH 
DHKVSI 
DHKCCH 
DHKCKP 
DHKCQY 
DHKDGD 
DHKGRF 
DHKLOG 
DHKHSW 
DHKPTR 
DHKSHC 
DHKTRD 
DHKVDD 
DHKWRH 
DHKCCH 
DHKCFS 
DHKCQH 
DHKDDR 
DHKEXT 
DHKIOS 
DHKHID 
DHKPGT 
DHKRSP 



DHKCFT 
DHKCQP 
DHKDDR 
DHKERH 
DHKICF 
DHKHCD 
DHKNLD 
DHKRGA 
DHKSIX 
DHKTRA 
DHKVCH 
DHKVSI 
DHKCCH 
DHKCFT 
DHKCQP 
DHKDDR 
DHKEBH 
DHKIOG 
DHKHCH 
DHKHLE 
DHKRGB 
DHKSHC 
DHKTRC 
DHKVDA 
DHKVSP 
DHKCCH 
DHKCKS 
DHKCSB 
DHKDIA 
DHKHVC 
DHKLCH 
DHKHES 
DHKQCH 
DHKSPL 
DHKTRK 
DHKVDE 

DHKCCW 
DHKCFT 
DHKCQP 
DHKDEF 
DHKFHT 
DHKISH 
DHKHHI 
DHKPRG 
DHKSAV 



DHKCKP 
DHKCQR 
DHKDEF 
DHKEXT 
DHKIOG 
DHKHCH 
DHKHLE 
DHKRGB 
DHKSHC 
DHKTRC 
DHKVDA 
DHKVSP 
DHKCDE 
DHKCKP 
DHKCQH 
DHKDEF 
DHKEXT 
DHKIOS 
DHKHCT 
DHKHHT 
DHKRHD 
DHKSPL 
DHKTRD 
DHKVDC 
DHKVSQ 
DHKCDE 
DHKCHS 
DHKCSO 
DHKDIB 
DHKHVD 
DHKLOK 
DHKHET 
DHKRGA 
DHKSSP 
DHKDDR 
DHKVDR 

DHKCDE 
DHKCKP 
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DHKDGD 
DHKFRE 
DHKJRL 
DHKHOH 
DHKPRV 
DHKSCH 



DHKCKS 
DHKCQY 
DHKDGD 
DHKFHT 
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DHKHHT 
DHKRHD 
DHKSPL 
DHKTRD 
DHKVDC 
DHKVSQ 
DHKCDH 
DHKCKS 
DHKCQY 
DHKDGD 
DHKFHT 
DHKISH 
DHKHIA 
DHKOPR 
DHKRHH 
DHKSSP 
DHKTRK 
DHKVDD 
DHKWRH 
DHKCDH 
DHKCPB 
DHKCSP 
DHKDIR 
DHKIOE 
DHKHCC 
DHKHLD 
DHKRGB 
DHKSSS 
DHKDDD 
DHKVDS 

DHKCDH 
DHKCKS 
DHK CQY 
DHKDIA 
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DHKLHK 
DHKHSG 
DHKPSA 
DHKSCH 



DHKCLK 
DHKCSB 
DHKDIA 
DHKFRE 
DHKISH 
DHKHIA 
DHKOPR 
DHKRHH 
DHKSSP 
DHKTRK 
DHKVDD 
DHKWRH 
DHKCDS 
DHKCLK 
DHKCSB 
DHKDIA 
DHKFRE 
DHKJRL 
DHKHID 
DHKPAG 
DHKRPA 
DHKSSS 
DHKTRH 
DHKVDE 

DHKCDS 
DHKCPI 
DHKCSQ 
DHKDHP 
DHKIOF 
DHKHCD 
DHKHLE 
DHKRHD 
DHKSTK 
DHKOHT 
DMKVER 

DHKCDS 
DHKCLK 
DHKCSB 
DHKDIB 
DHKGRF 
DHKLOG 
DHKHSW 
DHKPTR 
DHKSEP 



DHKCHS 
DHKCSO 
DHKDIB 
DHKGIO 
DHKJRL 
DHKHID 
DHKPAG 
DHKRPA 
DHKSSS 
DHKTRH 
DHKVDE 

DHKCFC 

DHKCHS 

DHKCSO 

DHKDIB 

DHKGIO 

DHKLDOOE 

DHKHHI 

DHKPGS 

DHKRSE 

DHKSTK 

DHKDDR 

DHKVDR 

DHKCFD 
DHKCPS 
DHKCST 
DHKDRD 
DHKIOG 
DHKHCH 
DHKOPR 
DHKRHH 
DHKSVC 
DHKOSO 
DHKVIO 

DHKCFC 
DHKCHS 
DHKCSO 
DHKDIR 
DHKGRT 
DHKLOH 
DHKHEH 
DHKQCH 
DHKSHC 



n 

t-» 
0) 

tr 

CD 
M 

I 

<+ 
o 
» 

OB 

o 
pi 



H" 
(0 

n 
1-1 
o 
in 

Ul 

w 
CD 
Ml 
CD 

CD 
D 
O 
CD 



LABEL 



COONT 



REFERENCES 



R12 



002131 



R13 



000753 



n 
o 

H 
<I> 
O 
(+ 

o 

M 

(n 



I 



Ria 



007292 



R15 



011325 



DMKSPL 
DMKTRD 
DMKVDC 
DMKVSQ 
DMKACO 
DMKCFD 
DMKCPB 
DMKCSP 
DMKDHP 
DMKGRT 
DMKLNK 
DMKMON 
DMKPRG 
DMKSAV 
DMKTCS 
DMKOSO 
DMKVIO 
DMKACO 
DMKCFD 
DMKCPB 
DMKCSP 
DMKDMP 
DMKGRT 
DMKLNK 
DMKNEM 
DMKRGA 
DMKSNC 
DMKTRD 
DMKVDC 
DMKACO 
DMKCFD 
DMKCPB 
DMKCSP 
DMKDIR 
DMKGRF 
DMKLNK 
DMKMON 
DMKPRG 
DMKSAV 
DMKTAP 
DMKUSO 
DMKVIO 
DMKACO 
DMKCFD 
DMKCPB 
DMKCSP 



DMKSSP 
DMKTRK 
DMKVDD 
DMKHRM 
DMKALG 
DMKCFG 
DMKCPI 
DMKCSQ 
DMKDRD 
DMKHVC 
DMKLOC 
DMKMSG 
DMKPRV 
DMKSCH 
DMKTDK 
DMKVAT 
DMKVMA 
DMKALG 
DMKCFG 
DMKCPI 
DMKCSQ 
DMKDRD 
DMKHVC 
DMKLOG 
DMKNES 
DMKRGB 
DMKSPL 
DMKTRK 
DMKVDD 
DMKALG 
DMKCFG 
DMKCPI 
DMKCSQ 
DMKDMP 
DMKGRT 
DMKLOC 
DMKMSG 
DMKPRV 
DMKSCH 
DMKTCS 
DMKVAT 
DMKVMA 
DMKALG 
DMKCFG 
DMKCPI 
DMKCSQ 



DMKSSS 
DMKTRM 
DMKVDE 

DMKAPI 
DMKCFH 
DMKCPS 
DMKCST 
DMKDSB 
DMKHVD 
DMKLOG 
DMKMSH 
DMKPSA 
DMKSEP 
DMKTHI 
DMKVCA 
DMKVMC 
DMKAPI 
DMKCFH 
DMKCPS 
DMKCST 
DMKDSB 
DMKHVD 
DMKLOH 
DMKNET 
DMKRND 
DMKSSP 
DMKTRM 
DMKVDE 
DHKAPI 
DMKCFH 
DMKCPS 
DMKCST 
DMKDRD 
DMKHVC 
DMKLOG 
DMKHSH 
DMKPSA 
DMKSCN 
DMKTDK 
DMKVCA 
DMKVMC 
DMKAPI 
DMKCFH 
DMKCPS 
DMKCST 



DMKSTK 
DHK0DR 
DMKVDR 

DMKATS 
DMKCFM 
DBKCPD 
DMKCSD 
DMKDSP 
DMKIMG 
DMKLOH 
DMKNEM 
DMKPTR 
DMKSEV 
DMKTMR 
DMKVCH 
DMKVMI 
DMKATS 
DMKCFM 
DMKCPO 
DMKCS0 
DMKDSP 
DMKIMG 
DMKMCC 
DHKNLD 
DMKRNH 
DHKSSS 
DMKDDR 
DMKVDR 
DMKATS 
DMKCFM 
DMKCPO 
DMKCSO 
DMKDSB 
DMKHVD 
DMKLOH 
DMKNES 
DMKPTR 
DMKSEP 
DMKTHI 
DMKVCH 
DMKVMI 
DMKATS 
DMKCFM 
DMKCPO 
DMKCSO 



DMKSVC 
DMKODO 
DMKVDS 

DMKBLD 
DMKCFO 
DMKCPV 
DMKCSV 
DHKEIG 
DMKIOC 
DMKLOK 
DMKNES 
DMKQCN 
DMKSIX 
DMKTRA 
DMKVCN 
DMKVSI 
DMKBLD 
DMKCFO 
DMKCPV 
DMKCSV 
DMKEIG 
DMKIOC 
DMKMCD 
DMKNLE 
DMKRPA 
DMKSVC 
DMKODU 
DMKVDS 
DMKBLD 
DMKCFO 
DMKCPV 
DMKCSV 
DMKDSP 
DMKIMG 
DMKLOK 
DMKNET 
DMKQCN 
DMKSEV 
DMKTMR 
DMKVCN 
DMKVSI 
DMKBLD 
DMKCFO 
DMKCPV 
DMKCSV 



DMKTAP 
DMKONT 
DMKVER 

DMKBSC 
DMKCFP 
DMKCQG 
DHKDAS 
DMKENT 
DMKIOE 
DMKMCC 
DMKNET 
DMKRGA 
DMKSNC 
DMKTRC 
DMKVDA 
DMKVSP 
DMKBSC 
DMKCFP 
DMKCQG 
DHKDAS 
DMKENT 
DMKIOE 
DHKHCH 
DMKPAG 
DMKRSE 
DMKTAP 
DMKONT 
DMKVER 
DMKBSC 
DMKCFP 
DMKCQG 
DMKCVT 
DMKEIG 
DMKIOE 
DMKMCC 
DMKNLD 
DMKRGA 
DMKSIX 
DMKTRA 
DMKVDA 
DMKVSP 
DMKBSC 
DMKCFP 
DMKCQG 
DMKCVT 



DMKTCS 
DMKOSO 
DMKVIO 

DMKCCH 
DMKCFS 
DMKCQH 
DMKDDR 
DMKERM 
DMKIOF 
DMKMCD 
DMKNLD 
DMKRGB 
DMKSPL 
DMKTRD 
DMKVDC 
DMKVSQ 
DMKCCH 
DMKCFS 
DMKCQH 
DMKDDR 
DMKERM 
DMKIOF 
DMKMIA 
DMKPGS 
DMKRSP 
DMKTCS 
DMKOSO 
DMKVMA 
DMKCCH 
DMKCFS 
DMKCQH 
DHKDAS 
DMKENT 
DMKIOF 
DMKMCD 
DMKNLE 
DMKRGB 
DMKSNC 
DMKTRC 
DMKVDC 
DMKVSQ 
DMKCCH 
DMKCFS 
DMKCQH 
DHKDAS 



DMKTDK 
DMKVAT 
DMKVMA 

DMKCCH 
DMKCFT 
DMKCQP 
DMKDEF 
DMKEXT 
DMKIOG 
DMKMCH 
DMKNLE 
DMKRND 
DMKSSP 
DMKTRK 
DMKVED 
DMKHRM 
DMKCCH 
DMKCFT 
DMKCQP 
DMKDEF 
DMKEXT 
DMKIOG 
DMKHID 
DMKPGT 
DMKSAV 
DMKTDK 
DMKVAT 
DMKVMC 
DMKCCH 
DMKCFT 
DMKCQP 
DMKDDR 
DMKERM 
DMKIOG 
DHKHCH 
DMKNMT 
DMKRND 
DMKSPL 
DMKTRD 
DMKVDD 
DMKHRM 
DMKCCH 
DMKCFT 
DMKCCP 
DMKDDR 



DMKTHI 
DMKVCA 
DMKVMC 

DMKCDE 
DMKCKP 
DMKCQR 
DHKDGD 
DMKFMT 
DMKIOS 
DMKMCT 
DMKNMT 
DMKRNH 
DMKSSS 
DMKTRM 
DMKVDE 

DMKCDE 
DMKCKP 
DMKCQR 
DMKDGE 
DMKFMT 
DMKIOS 
DMKMNI 
DMKPRG 
DMKSCH 
DMKTHI 
DMKVCA 
DMKVMI 
DMKCDE 
DMKCKP 
DMKCQR 
DMKDEF 
DMKEXT 
DMKIOS 
DMKMCT 
DMKOPR 
DMKRNH 
DMKSSP 
DMKTRK 
DMKVDE 

DMKCDE 
DMKCKP 
DMKCQR 
DMKDEF 



DMKTMR 
DMKVCH 
DMKVMI 

DMKCDM 
DMKCKS 
DMKCQY 
DMKDIA 
DMKFRE 
DHKISM 
DMKMIA 
DMKPAG 
DMKRPA 
DMKSTK 
DMKDDR 
DMKVDR 

DHKCDM 
DMKCKS 
DMKCQY 
DMKDIA 
DMKFRE 
DMKISM 
DMKMON 
DMKPRV 
DMKSEP 
DMKTMR 
DMKVCH 
DMKVSI 
DMKCDM 
DMKCKS 
DMKCQY 
DHKDGD 
DMK FMT 
DMKISH 
DMKMIA 
DMKPAG 
DMKRPA 
DHKSSS 
DMKDDR 
DMKVDR 

DMKCDM 
DMKCKS 
DMKCQY 
DHKDGD 
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DMKVCN 
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DMKCDS 
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DHKDIB 
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DHKJRL 
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DMKCSB 
DMKDIB 
DMKGIO 
DHKJRL 
DMKMSG 
DMKPTR 
DMKSEV 
DMKTRA 
DMKVCN 
DMKVSP 
DMKCDS 
DHKCLK 
DMKCSB 
DMKDIA 
DMKFRE 
DHKJRL 
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DMKPGS 
DMKRSE 
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DHKCDS 
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DMKDIA 
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DMKVSP 
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DMKCSO 

DMKDIR 

DMKGRF 
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DMKPGT 

DMKRSP 
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DMKVER 

DMKCFC 
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DMKLDOOE 
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DHKQCN 

DHKSIX 

DHKTRC 

DHKVDA 
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DHKCFC 

DHKCNS 
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DMKDIB 

DHKGIO 
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DMKMNI 

DMKPGT 

DHKRSP 

DMKSVC 

DMKONT 

DMKVER 
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DMKCNS 
DMKCSO 
DHKDIB 
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DMKDIR 


DMKDMP 
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DMKMCH 


DMKMCT 


DMKMIA 


DMKMID 


DMKMNI 


DMKMON 


DMKMSG 






DMKMSW 


DMKNEM 


DMKHES 


DMKNET 


DMKNLD 


DMKNLE 


DMKNMT 


DMKOPR 


DMKPAG 


DMKPGS 


DMKPGT 


DMKPRG 






DMKPRV 


DMKPSA 


DMKPTR 


DMKQCN 


DMKRGA 


DMKRGE 


DMKRND 


DMKRNH 


DMKRPA 


DMKRSE 


DMKRSP 


DMKSAV 






DMKSCH 


DMKSCN 


DMKSEP 


DMKSEV 


DMKSIX 


DHKSNC 


DMKSPL 


DMKSSP 


DMKSSS 


DMKSTK 


DMKSVC 


DMKTAP 






DMKTCS 


DMKTDK 


DMKTHI 


DMKTMR 


DMKTRA 


DMKTRC 


DMKTRD 


DMKTRK 


DMKTRM 


DMKODR 


DMKODO 


DMKONT 






DMKDSO 


DMKVAT 


DMKVCA 


DMKVCH 


DMKVCN 


DHKVD1 


DMKVDC 


DMKVED 


DMKVDE 


DMKVDR 


DMKVDS 


DMKVER 






DMKVIO 


DMKVMA 


DMKVMC 


DHKVMI 


DHKVSI 


DMKVSP 


DMKVSQ 


DMKWRM 












004873 


DMKACO 


DMKALG 


DMKAPI 


DMKATS 


DMKBLD 


DMKBSC 


DMKCCH 


DMKCCW 


DMKCDE 


DMKCDM 


DMKCDS 


DMKCFC 






DMKCFD 


DMKCFG 


DMKCFH 


DMKCFM 


DMKCFO 


DMKCFE 


DMKCFS 


DMKCFT 


DMKCKP 


DMKCKS 


DMKCNS 


DMKCPB 






DMKCPI 


DMKCPS 


DMKCP0 


DMKCPV 


DMKCQG 


DHKCQH 


DMKCQP 


DMKCQH 


DMKCQY 


DMKCSB 


DMKCSO 


DMKCSP 






DMKCSQ 


DMKCST 


DMKCSO 


DMKCSV 


DHKDAS 


DMKDDR 


DMKDEF 


DMKEGE 


DMKDIA 


DMK DIB 


DMKDIR 


DMKDMP 






DMKDRD 


DMKDSB 


DMKDSP 


DMKEIG 


DMKENT 


DMKERM 


DMKEXT 


DMKFMT 


DMKFRE 


DMK G 10 


DMKGRF 


DMKGRT 






DMKHVC 


DMKHVD 


DMKIMG 


DMKIOC 


DMKIOE 


DMKIOF 


DMKIOG 


DMKIOS 


DMKISM 


DMKJRL 


DMKLDOOE 


DMKLNK 






DMKLOC 


DMKLOG 


DMKLOH 


DMKLOK 


DMKMCC 


DMKMCD 


DMKMCH 


DMKMCT 


DMKMIA 


DMKMID 


DMKMNI 


DMKMON 






DMKMSG 


DMKMSW 


DMKNEM 


DMKNES 


DMKNET 


DMKNLD 


DMKNLE 


DMKNMT 


DMKOPR 


DMKPAG 


DMKPGS 


DMKPGT 






DMKPRS 


DMKPRV 


DMKPSA 


DMKPTR 


DMKQCN 


DMKRGA 


DMKRGB 


DMKRND 


DMKRNH 


DMKRSE 


DMKRSP 


DMKSAV 






DMKSCH 


DMKSCH 


DMKSEP 


DMKSEV 


DMKSIX 


DMKSNC 


DMKSPL 


DMKSSP 


DMKSSS 


DMKSTK 


DMKSVC 


DMKTAP 






DMKTCS 


DMKTDK 


DMKTHI 


DMKTMR 


DMKTRA 


DMKTRC 


DMKTRD 


DMKTRK 


DNKTRM 


DMKUDR 


DMK U DO 


DMKONT 





LABEL 



R5 



R6 



R7 



O 

H 
(D 
O 
r+ 
O 
M 
H- 
(D 
M 



I 

U) 



R8 



COUNT 


REFERENCES 


























DMKUSO 


DMKTAT 


DMKVCA 


DMKVCH 


DMKVCN 


DMKVDA 


DMKVDC 


DMKVED 


DMKVDE 


DMKVDR 


DMKVDS 


DMKVER 






DHKVIO 


DMKVNA 


DMKVMC 


DMKVMI 


DMKVSI 


DMKVSP 


DMKVSQ 


DHKWRH 












004606 


DMKACO 


DMKATS 


DMKBLD 


DMKBSC 


DMKCCH 


DMKCCH 


DMKCDB 


DMKCEM 


DMKCDS 


EMKCFC 


DMKCFD 


DMKCFG 






DMKCFH 


DMKCFM 


DMKCFO 


DMKCFP 


DMKCFS 


DMKCFT 


DMKCKP 


DMKCKS 


DMKCNS 


BMKCPB 


DMKCPI 


DMKCPS 






DMKCPU 


DMKCPV 


DMKCQG 


DMKCQH 


DMKCQP 


DMKCQR 


DMKCQY 


DMKCSB 


DMKCSO 


BMKCSP 


DMKCSQ 


DMKCST 






DMKCSU 


DMKCSV 


DMKCVT 


DMKDAS 


DMKDDR 


DMKDEF 


DHKDGD 


DMKDIA 


DHKDIR 


DMKDMP 


DMKDRD 


DMKDSB 






DMKDSP 


DMKENT 


DMKERM 


DMKEXT 


DMKFMT 


DMKFRE 


DMKGIO 


DMKGRF 


DMKGRT 


DMKHVC 


DMK HVD 


DHKIHG 






DMKIOC 


DMKIOE 


DMKIOF 


DMKIOG 


DMKIOS 


DMKISH 


DMKJRL 


DMKLEOOE 


DMKLNK 


DMKLOC 


DMKLOG 


DMKLOH 






DMKLOK 


DMKMCC 


DMKMCD 


DMKMCH 


DMKHIA 


DMKMID 


DMKMNI 


DMKMCN 


DMKMSG 


DMKMSW 


DMKNEM 


DMKNES 






DMKNET 


DMKNLD 


DMKNLE 


DMKNMT 


DMKOPR 


DMKPAG 


DMKPGS 


DMKPGT 


DMKPRG 


DMKPRV 


DMKPSA 


DMKPTR 






DMKQCN 


DMKRGA 


DMKRGB 


DMKRNH 


DMKRPA 


DMKRSE 


DMKRSP 


DMKSAV 


DMKSCH 


DMKSCN 


DMKSEP 


DMKSNC 






DHKSPL 


DMKSSP 


DMKSSS 


DMKSTK 


DMKSVC 


DHKTAE 


DMKTCS 


DMKTDK 


DMKTHI 


DMKTMR 


EMKTRA 


DMKTRC 






DMKTRD 


DMKTRK 


DMKTRM 


DMKODR 


DMKODD 


DHKDNT 


DMKUSO 


DMKV AT 


BMKVCA 


DMKVCH 


BMKVCN 


DMKVDA 






DMKVDC 


DMKVDD 


DMKVDE 


DMKVDS 


DMKVER 


DMKVIC 


DMKVMA 


DMKVMC 


DMKVMI 


DMKVSI 


EMKVSP 


DMKVSQ 






DMKWRM 


























003264 


DMKACO 


DMKATS 


DMKBLD 


EHKBSC 


DMKCCH 


DMKCCH 


DMKCDB 


DMKCDM 


DMKCDS 


DMKCFC 


BMKCFD 


DMKCFG 






DMKCFH 


DMKCFM 


DMKCFO 


DMKCFP 


DMKCFS 


DMKCFT 


DMKCKP 


DMKCKS 


DMKCNS 


DMKCPB 


DMKCPI 


DMKCPS 






DMKCPU 


DMKCPV 


DMKCQG 


DMKCQP 


DMKCQR 


DMKCQY 


DHKCSB 


DMKCSO 


DMKCSP 


DMKCSQ 


DMKCST 


DMKCSU 






DMKCSV 


DMKCVT 


DMKDAS 


DMKDDR 


DMKDEF 


DHKDGD 


DHKDIA 


CMKDIB 


DMKDIR 


DMKDMP 


DMKDRD 


DMKDSB 






DMKDSP 


DMKENT 


DMKERM 


DMKEXT 


DMKFMT 


DMKFRE 


DMKGIO 


DMKGRF 


DMKGRT 


DMKHVC 


DMK HVD 


DMKIHG 






DMKIOC 


DMKIOE 


DMKIOF 


DMKIOG 


DMKIOS 


DMKISH 


DMKJRL 


DMKLEOOE 


DMKLNK 


DMKLOC 


DMKLOG 


DHKLOH 






DMKLOK 


DMKMCC 


DMKMCD 


DMKMCH 


DHKHCT- 


DMKHIA 


DMKMID 


DMKMNI 


DMKMON 


DMKMSW 


DMKNES 


DMKNET 


O 




DMKNLD 


DMKNLE 


DMKNMT 


DMKPAG 


DMKPGT 


DMKPRG 


DMKPRV 


DMKPTR 


DMKQCN 


DMKRGA 


DMKRGB 


DMKRND 


♦T3 




DMKRNH 


DMKRSE 


DMKRSP 


DMKSAV 


DMKSCH 


DMKSCH 


DMKSEP 


DMKSNC 


DMKSPL 


BMKSSP 


DMKSSS 


DMKSTK 


tr* 




DMKSVC 


DMKTAP 


DMKTCS 


DMKTDK 


DMKTHI 


DMKTMB 


DMKTRC 


DMKTRD 


DMKTRK 


EMKDDR 


DMKODO 


DHKONT 


o> 




DMKOSO 


DMKVAT 


DMKVCA 


DMKVCH 


DMKVCN 


DMKVDA 


DMKVDC 


DMKVEE 


DMKVDE 


DMKVDR 


DMKVDS 


DHKVER 






DMKVIO 


DMKVMA 


DMKVMC 


DMKVMI 


DMKVSI 


DMKVSP 


DMKVSQ 


DHKWRM 










003705 


DMKACO 


DMKALG 


DMKATS 


DMKBLD 


DMKBSC 


DMKCCH 


DMKCCW 


DMKCDE 


DMKCDM 


DMKCBS 


DMKCFC 


DMKCFD 


1 




DMKCFG 


DMKCFH 


DMKCFM 


DMKCFO 


DMKCFP 


DMKCFS 


DMKCFT 


DMKCKP 


DMKCKS 


DMKCNS 


DMKCPB 


DMKCPI 


O 
1 




DMKCPS 


DMKCPU 


DMKCPV 


DMKCQG 


DMKCQP 


DMKCQR 


DMKCQY 


DMKCSO 


DMKCSP 


DMKCSQ 


DMKCST 


DMKCSU 




DMKCSV 


DMKCVT 


DMKDAS 


DMKDDR 


DMKDEF 


DHKDGD 


DMKDIA 


EMKDIE 


DMKDIR 


DMKDMP 


DMKDRD 


DMKDSB 


DC 




DMKDSP 


DMKENT 


DMKERM 


DMKFMT 


DMKFRE 


DMKGIC 


DMKGRF 


BMKGBT 


DMKHVC 


DHKHVD 


DMK IMG 


DMKIOE 


O 




DMKIOF 


DMKIOG 


DMKIOS 


DMKISM 


DMKJRL 


DMKLDOOE 


DMKLNK 


DMKLCC 


DMKLOG 


DMKLOB 


DMKMCC 


DMKHCD 







DMKMCH 


DMKHIA 


DMKMID 


DMKMNI 


DMKMON 


DMKMSG 


DMKMSW 


DMKNES 


DMKNET 


DMKNLD 


DMKNLE 


DMKNMT 


(0 




DMKPAG 


DMKPGS 


DMKPGT 


DMKPRG 


DMKPRV 


DHKPSA 


DMKPTR 


DMKQCN 


DMKRGA 


DMKRGB 


DHKRND 


DMKRNH 




DHKRPA 


DMKRSE 


DMKRSP 


DMKSAV 


DMKSCH 


DMKSCN 


DMKSEP 


DMKSNC 


DMKSPL 


DMKSSP 


DMKSSS 


DHKSVC 


n 




DMKTAP 


DMKTCS 


DMKTDK 


DMKTHI 


DMKTHR 


DMKTRC 


DMKTRD 


DMKTRK 


DMKDDR 


DMKODO 


DHKONT 


DMKUSO 


o 

w 




DMKVAT 


DMKVCA 


DMKVCH 


DMKVCN 


DMKVDA 


DMKVDC 


DMKVDD 


BMKVBE 


DMKV DS 


DMKVER 


DMKVIO 


DHKVHA 




DMKVMC 


DMKVMI 


DMKVSI 


DMKVSP 


DMKVSQ 


DMKWRH 














CO 


002748 


DMKACO 


DMKALG 


DMKATS 


DMKBLD 


DMKBSC 


DMKCCH 


DMKCCW 


DMKCDE 


DMKCDM 


DMKCDS 


DMKCFC 


DHKCFD 


so 




DMKCFG 


DMKCFH 


DMKCFM 


DMKCFO 


DMKCFP 


DMKCFS 


DMKCFT 


BMKCKP 


DMKCKS 


DMKCNS 


DMKCPB 


DMKCPI 


<D 




DMKCPS 


DMKCPO 


DMKCPV 


DMKCQG 


DMKCQP 


DMKCQR 


DMKCQY 


DMKCSB 


DMKCSO 


DMKCSP 


DMKCSQ 


DMKCST 


hh 




DMKCSO 


DMKCSV 


DMKCVT 


DMKDAS 


DMKDDR 


DMKDEF 


DMKDGD 


DMKDIA 


DMKDIB 


DMKDMP 


DMKDRD 


DMKDSB 


(0 




DMKDSP 


DMKENT 


DMKERM 


DMKFMT 


DMKFRE 


DMKGIC 


DMKGRF 


DMKGHT 


DMKHVC 


DMKHVD 


DHKIHG 


DMKIOC 


(D 




DMKIOE 


DMKIOF 


DMKIOG 


DMKIOS 


DMKISM 


DMKJRL 


DMKLDOOE 


DMKLNK 


DMKLOC 


DMKLOG 


DHKLOH 


DMKMCC 


P 
O 
(0 




DMKMCD 


DMKMCH 


DMKMIA 


DMKMID 


DMKMNI 


DMKMON 


DMKMSG 


EHKMSW 


DMKNES 


DMKNET 


DMKNLD 


DMKNLE 



» 


LABEL 


COUNT 


REFERENCES 






















n 


-J 
to 






DHKHMT 


DMKOPR 


DMKPAG 


DMKPGS 


DHKPGT 


DHKPRG 


DHKPBV 


DHKPSA 


DHKPTB 


DHKQCN 


DMKRGA 


DHKRGB 


0) 
U 1 








DHKRHH 


DMKRSE 


DMKRSP 


DHKSAV 


DMKSCH 


DHKSCH 


DHKSEP 


DHKSHC 


DHKSPL 


DHKSSP 


DHKSSS 


DMKSVC 


(D 


H 






DHKTAP 


DMKTCS 


DMKTDK 


DMKTHI 


DMKTHR 


DHKTRC 


IJBKTBD 


DHKTBK 


DMKTBM 


DHKUDB 


DHKUDU 


DMKUHT 


1 


to 

at 






DHKOSO 


DMKVAT 


DMKVCA 


DHKVCH 


DHKVCH 


DHKVDA 


DMKVDC 


DHKVEE 


DMKVDE 


DHKVDR 


DHKVDS 


DHKVER 


1 








DMKVIO 


DMKVMA 


DMKVMC 


DMKVSI 


DHKVSP 


DHKVSQ 


DHKHBH 












3! 


•< 
at 
\ 


B9 


002530 


DMKACO 


DHKALG 


DHKATS 


DHKBLD 


DHKBSC 


DHKCCH 


DMKCCH 


DHKCEB 


DMKCDS 


DMKCFC 


DHKCFG 


DMKCFH 






DHKCFH 


DMKCFO 


DMKCFP 


DHKCFS 


DHKCKP 


DHKCKS 


DBKCHS 


DHKCPI 


DHKCPS 


DHKCPD 


DHKCPV 


DHKCQG 


O 


U) 






DHKCQH 


DHKCQP 


DHKCQR 


DHKCQY 


DHKCSB 


DHKCSC 


DMKCSP 


DHKCSQ 


DHKCST 


DHKCSO 


DHKCSV 


DMKCVT 


Dj 


o 






DMKDAS 


DMKDDR 


DHKDEF 


DHKDGD 


DHKDIA 


DHKDIE 


DBKDIB 


DHKEHP 


DHKDBD 


DMKDSP 


DHKEIG 


DMKEHT 


H 








DHKERH 


DMKFMT 


DMKFRE 


DHKGIO 


DHKGRF 


DHKHVC 


DHKHVD 


DHKIHG 


DHKIOC 


DHKIOE 


DHKIOF 


DHKIOG 


0) 
CO 






DMKIOS 


DMKISM 


DMKJRL 


DHKLD00E 


DHKLNK 


DHKLOC 


DHKLOG 


DHKLCH 


EHKLOK 


DHKHCC 


EHKHCD 


DHKHCH 


n 
n 






DMKMCT 


DMKMIA 


DHKMID 


DHKHHI 


DHKHOH 


DHKHSG 


DHKHSH 


DMKNES 


DHKHET 


EHKNLD 


DHKHLE 


DHKHHT 


rt 






DMKPAG 


DMKPGS 


DHKPGT 


DHKPRG 


DHKPRV 


DHKPTB 


DHKQCH 


BHKBGA 


DHKBGE 


EHKRHH 


DHKRPA 


DHKRSE 


o 


(D 






DHKRSP 


DMKSAV 


DMKSCH 


DHKSCH 


DHKSEP 


DMKSEV 


DHKSIX 


DHKSHC 


DHKSPL 


BHKSSP 


DHKSSS 


DHKTAP 




B 






DHKTCS 


DMKTDK 


DMKTHI 


DHKTHR 


DHKTRA 


DHKTRC 


DHKTBD 


DHKTBK 


DHKUDB 


DHKUDO 


DMKOHT 


DMKUSO 


£4 






DMKVAT 


DMKVCA 


DMKVCH 


DHKVCH 


DMKVDA 


DMKVDC 


DMKVDD 


DHKVDE 


DMKVDS 


DHKVER 


DHKVHA 


DMKVHC 


» 


O 






DMKVMI 


DMKVSI 


DMKVSP 


DHKVSQ 


DHKWRH 
















Ml 
(0 


SAVCREGS 


000007 


DMKCFG 


DMKCFH 






















O 


SAVE 


000026 


DHKBLD 


DMKDSP 


DMKEHB 


DHKFRE 


DHKIOS 


DHKPRV 


DHKPTB 


DHKSCH 


DMKTMB 


EHKVHA 


DHKVSI 




M 


DJ 


SAVEAB 


000007 


DMKIMG 


DMKRHD 






















(D 


a 


SAVEAREA 


000175 


DMKACO 


DMKALG 


DMKAPI 


DHKATS 


DHKBLD 


DHKBSC 


DHKCCH 


DHKCCH 


DHKCDE 


EHKCDH 


DHKCDS 


DHKCFC 


O 


Pi 






DMKCFD 


DMKCFG 


DMKCFH 


DHKCFH 


DHKCFO 


DHKCFE 


DBKCFS 


DHKCFT 


DHKCKS 


DHKCLK 


DHKCNS 


DHKCPB 


a> 


ha 






DMKCPS 


DMKCPO 


DMKCPV 


DHKCQG 


DHKCQH 


DHKCQP 


DHKCQB 


DHKCQY 


DHKCSB 


DHKCSO 


DHKCSP 


DHKCSQ 




« 






DHKCST 


DHKCS0 


DMKCSV 


DHKDAS 


DHKDDR 


DHKDEF 


DHKDGD 


DHKEIA 


DHKDIB 


DHKDIR 


DMKDRD 


DMKDSB 




o 
tr 

M 






DHKEIG 


DHKEHT 


DHKERH 


DHKFHT 


DHKGIO 


DHKGRF 


DMKGBT 


DHKHVD 


DHKIOC 


DHKIOE 


DHKIOF 


DMKIOG 








DMKIOS 


DMKISM 


DHKJRL 


DHKLNK 


DHKLOG 


DMKLOH 


DHKHCC 


DHKHCE 


DHKHCH 


DMKHIA 


DHKHID 


DHKHHI 




fl> 






DMKMOH 


DHKMSG 


DHKHSH 


DHKHEH 


DHKNES 


DHKNET 


DHKNLD 


DHKNLE 


DHKPGS 


DHKPTR 


DHKQCN 


DHKRGA 




a 






DHKRGB 


DMKRNH 


DHKRPA 


DHKRSE 


DHKRSP 


DHKSEP 


DMKSEV 


DHKSIX 


DHKSHC 


DHKSPL 


DHKSSP 


DHKSSS 




o 






DMKSVC 


DMKTAP 


DHKTCS 


EHKTDK 


DHKTHI 


DHKTRA 


DHKTRC 


DHKTBE 


DHKTBK 


DMKTRM 


DHKUDR 


DHKUDU 




(D 
(D 






DMKUNT 


DMKOSO 


DMKVAT 


DMKVCA 


DHKVCH 


DHKVDA 


DHKVDC 


DHKVEE 


DHKVDE 


DHKVDR 


DHKVDS 


DHKVER 








DMK7MA 


DMKVMC 


DMKVSP 


DHKWRH 




















M 


SAVENEXT 


000004 


DMKSVC 


























m 

H* 


SAVEPROC 


000010 


DMKPTR 


DMKSVC 
























» 


SAVEREGS 


000545 


DMKACO 


DMKALG 


DMKAPI 


DHKATS 


DHKBLD 


DHKBSC 


DHKCCH 


DHKCCH 


DHKCDB 


DHKCDH 


DHKCDS 


DHKCFC 




$» 






DMKCFD 


DMKCFG 


DMKCFH 


DHKCFH 


DHKCFO 


DMKCFP 


DHKCFS 


DHKCFT 


DHKCKS 


DHKCLK 


DHKCPB 


DHKCPS 










DMKCP0 


DMKCPV 


DMKCQG 


DHKCQH 


DHKCQP 


DHKCQB 


DHKCQY 


DHKCSB 


DHKCSO 


DHKCSP 


DHKCSQ 


DHKCST 




O 






DMKCS0 


DMKCSV 


DHKDAS 


DHKDDR 


DHKDEF 


DHKDGD 


DHKDIA 


EHKEIB 


DHKDIB 


DHKDRD 


DHKDSB 


DHKEHT 




a 
i 






DMKERM 


DHKGIO 


DHKGRT 


DHKHVD 


DHKIOC 


DHKIOE 


DHKIOF 


EHKIOG 


DHKIOS 


DHKISH 


DHKJRL 


DHKLHK 




l 






DMKLOG 


DMKLOH 


DHKHCC 


DHKHCD 


DMKHCH 


DMKMIA 


DHKHID 


DHKHNI 


DHKHOH 


DHKHSG 


DHKHSH 


DHKHEH 




<1 






DMKNES 


DMKNET 


DHKNLD 


DHKNLE 


DHKPGS 


DHKPTB 


DHKQCN 


DMKBGB 


DHKBHB 


DMKRPA 


DHKRSE 


DMKRSP 




o 






DMKSEP 


DMKSHC 


DMKSPL 


DHKSSS 


DHKTAP 


DHKTCS 


DHKTDK 


DMKTHI 


DHKTBA 


DHKTRC 


DHKTRD 


DNKTRK 




a 






DMKTRM 


DMKODR 


DHKUDU 


DHK0HT 


DHKDSO 


DMKVAT 


DHKVCA 


DHKVCH 


DHKVDA 


DHKVDC 


DHKVDD 


DMKVDE 




(D 






DMKVDR 


DMKVDS 


DHKVER 


DHKVHC 


DHKVHI 


DHKVSP 


DHKHRH 














SAYERETN 


000034 


DMKCFC 


DMKCFG 


DHKCPB 


EHKDIA 


DHKLHK 


DHKLOG 


DHKPTR 


DHKSSS 


DMKSVC 


DMKUSO 


DHKVAT 


DMKVCA 




"* 


SAVERTN 


000001 


DMKVER 
DMKSVC 





























LABEL 


COUNT 


REFERENCES 


























SAVER 


000062 


DHKCNS 


DMKCQG 


DMKCQH 


DHKCQP 


DMKCQR 


DHKCQY 


DHKDRD 


DHKERH 


DHKGRF 


DHKHVD 


DMKJRL 


DHKLNK 










DHKHSH 


DMKNEM 


DMKPTR 


DMKQCN 


DHKRNH 


DHKRSE 


DMKSNC 


DMKSVC 


DMKTDK 


DHKTRC 


DHKTRD 


DHKUDR 










DHKVAT 


DMKVCA 


DMKVDC 


DMKVSP 






















SAVER 1 


000080 


DMKBLD 


DMKCCH 


DMKCFC 


DHKCKS 


DHKCNS 


DMKCPU 


DHKCQP 


DHKERH 


DHKIOE 


DHKLNK 


DHKHIA 


DHKHON 










DHKPGS 


DMKPTR 


DMKQCN 


DMKRNH 


DHKRPA 


DHKSSS 


DHKTDK 


DHKTRC 


DHKTRD 


DHKTRK 


DHKVAT 


DHKVCA 










DHKVDS 


DMKVSP 


























SAYER10 


000019 


DHKCCH 


DMKSEP 


DMKVCA 


DHKVCH 


DHKVDC 


DHKVDE 


















SAVER 11 


000079 


DMKACO 


DMKALG 


DMKAPI 


DMKBLD 


DHKCFH 


DHKCFC 


DHKCFP 


DHKCPS 


DHKCPU 


DHKCPV 


DHKCQG 


DHKCQP 










DHKCSV 


DMKDAS 


DMKDIA 


DMKIOE 


DHKIOS 


DHKLNK 


DHKLOG 


DMKHIE 


DHKMSG 


DMKMSH 


DHKNES 


DHKNLD 










DMKPTR 


DMKQCN 


DMKSPL 


DMKTCS 


DHKTHI 


DMKUNT 


DMKVCA 


DHKVCH 


DHKVDA 


DHKVDD 


DHKVHC 








SAVER 12 


000024 


DMKCCH 


DMKCPV 


DHKDGD 


DMKHCC 


DHKHCD 


DMKPGS 


DHKPTR 


DHKSSS 


DMKSVC 


DHKVAT 


DHKVCA 


DHKVER 






SAVER 13 


000010 


DMKPGS 


DMKPTR 


DMKSVC 


DMKVAT 


DHKVDC 


DHKVDE 


















SAVER2 


000196 


DMKACO 


DMKALG 


DMKBLD 


DMKCCH 


DHKCDS 


DHKCFC 


DHKCFH 


DHKCKS 


DHKCNS 


DHKCPS 


DHKCQG 


DHKCQH 










DMKCQP 


DMKDEF 


DMKDGD 


EHKDIA 


DMKDIB 


DHKDRD 


DMKERM 


DHKGIO 


DHKGRF 


DHKLNK 


DHKLOG 


DHKLOH 










DMKMIA 


DHKMNI 


DMKMSG 


DHKNES 


DMKNET 


DMKNLD 


DMKNLE 


DHKPGS 


DMKPTR 


DHKQCN 


DHKRGA 


DMKRGB 










DMKRNH 


DMKRPA 


DMKSNC 


DHKSSS 


DHKTRA 


DMKTRC 


DHKTRD 


DHKUER 


DMKVAT 


DHKVCH 


DHKVDA 


DMKVDC 










DMKVDD 


DMKVDE 


DMKVDS 


DMKVHC 


DHKVSP 


DHKHRM 


















SAVER 3 


000011 


DMKERN 


DMKPGS 


DMKPTR 


EHKQCN 


DHKVAT 




















SAVER4 


000002 


DMKCCH 


DMKTRC 


























SAVER5 


000010 


DMKCFG 


DHKMON 


DMKTRC 


EHKVCA 


DHKVHC 




















SAVER6 


000009 


DMKCFG 


DMKDRD 


DMKSNC 


DMKVHC 






















SAVER7 


000003 


DMKPTR 


DMKSPL 


DMKTRK 




















o 




SAVER8 


000026 


DMKBLD 
DMKVSP 


DMKCCH 


DMKCFP 


DHKCKS 


DHKDIA 


DMKSEE 


DHKSPL 


DHKTBK 


DMKTRK 


DHKUNT 


DHKVDR 


DMKVDS 






SAVER9 


000006 


DMKALG 


DMKCCH 


DHKNES 


DHKNET 


DHKSPL 
















p> 




SAVESIZE 


000013 


DMKCPI 


DHKFRE 


DHKLNK 


DMKSVC 


DHKVDA 
















CD 
H 




SAVEHRK1 


00134<* 


DMKACO 


DMKALG 


DMKATS 


EHKBLD 


DHKCCH 


DHKCCW 


DHKCDB 


DHKCDM 


DHKCDS 


DHKCFC 


DHKCFD 


DMKCFG 








DMKCFH 


DMKCFO 


DMKCFS 


DHKCFT 


DHKCKS 


DMKCPS 


DMKCPU 


DMKCPV 


DHKCQG 


DHKCQH 


DHKCQP 


DMKCQR 


1 

o 








DMKCQY 


DMKCSB 


DHKCSO 


DHKCSP 


DHKCSQ 


DHKCST 


DMKCSU 


DMKCSV 


DHKDEF 


EHKDIA 


EHKDIB 


DMKDRD 


o 






DMKEIG 


DHKLNK 


DHKLOG 


DHKLOH 


DMKHCC 


DHKHCD 


DMKMIA 


DMKHON 


DHKHSG 


DHKNES 


DHKNET 


DMKNLD 


1 


V 






DMKNLE 


DMKPGS 


DHKPTR 


DMKQCN 


DHKRPA 


DHKRSE 


DMKSEP 


DHKSEV 


DHKSIX 


DHKSNC 


DHKSPL 


DHKSSS 


as 
o 
Pi 


o 






DMKTAP 


DMKTCS 


DMKTHI 


DMKTRA 


DHKTRC 


DHKTRD 


DMKTRK 


DHKUNT 


DMKUSO 


DHKVCA 


DHKVCH 


DHKVDA 


H- 






DMKVDC 


DMKVDD 


DHKVDE 


DHKVDS 


DHKVER 


DHKVHC 


DHKHRH 












d 


n 

CD 

o 


SAVEHRK2 


000696 


DMKACO 


DMKATS 


DMKBLD 


DMKCCH 


DHKCCH 


DMKCDH 


DHKCDS 


DHKCFC 


DHKCFD 


DHKCFG 


DHKCFH 


DHKCFO 


CD 






DMKCFS 


DMKCKP 


DMKCKS 


DHKCPB 


DHKCPS 


DMKCPU 


DMKCPV 


DHKCQG 


DHKCQH 


DHKCQP 


DHKCQR 


DHKCQY 




o 

t-J 






DMKCSB 


DMKCSO 


DMKCSP 


DHKCSQ 


DHKCST 


DMKCSO 


DMKCSV 


DHKDAS 


DHKDEF 


DMKDIA 


EHKDRD 


DKKIOG 


n 






DMKIOS 


DHKLNK 


DHKLOG 


DHKHID 


DHKMSG 


DHKNES 


DMKNET 


DHKNLB 


DHKNLE 


DMKPGS 


DHKPTR 


DHKQCN 


o 


H« 






DMKRPA 


DMKRSE 


DHKSEP 


DHKSNC 


DHKSPL 


DHKSSS 


DMKSVC 


DHKTCS 


DHKTDK 


DMKTHI 


DHKTRA 


DHKTRC 


en 


CD 

w 






DMKTRD 


DMKTRK 


DHK0DR 


DHKDNT 


DMKOSO 


DHKVCA 


DHKVCH 


DHKVDA 


DHKVDC 


DMKVDD 


DHKVDR 


DMKVDS 


t/> 






DMKVER 


DMKVSP 


DHKHRH 




















w 




SAVEHRK3 


000200 


DMKACO 


DMKATS 


DMKCCH 


DHKCDS 


DHKCFD 


DMKCFG 


DHKCFO 


DHKCKS 


DHKCPS 


DMKCPU 


DHKCPV 


DMKCQG 


CD 








DMKCQP 


DMKCSO 


DMKDAS 


DHKDEF 


DHKDIA 


DMKDRD 


DMKMCC 


DHKHCD 


DHKHIA 


DMKHSG 


DHKNES 


DMKNET 


CD 


_k 






DMKNLD 


DMKNLE 


DMKPGS 


EMKQCN 


DHKRSE 


DHKSNC 


DHKSSS 


DHKTCS 


DHKTHI 


DHKTRC 


DHKTRK 


DMKUNT 


1 






DMK0SO 


DMKVCA 


DMKVDA 


DMKVDC 


DHKVDD 


DMKVDF 


DHKVDS 


DHKVER 


DHKHRH 








CD 


U) 


SAVEHRK4 


000253 


DMKATS 


DMKCCH 


DMKCCH 


EHKCDB 


DHKCDM 


DHKCDS 


DHKCFC 


DHKCFD 


DHKCFG 


DHKCFH 


DHKCFO 


DMKCFS 




o 


u> 






DMKCKS 


DMKCPB 


DMKCPS 


DMKCPU 


DHKCPV 


DHKCQG 


DHKCQP 


DHKCQY 


DMKCSB 


DMKCSO 


DHKCSP 


DHKCSQ 


CD 



I 
"i 

-Cr 



H 

CD 

< 
OK 

\ 

U) 

'J 
o 

w 

l*« 

w 

rt 
(D 

a 

o 

ua 

o 

o> 

o 
Pi 

T> 
f-J 
O 

tr 

M 

(B 

a 

a 
<t> 

rt 
(D 
li 

a 

H" 

a 
pj 

rt- 
H- 
O 

a 
I 
I 

<4 
O 
M 



LABEL 


COONT 


REFERENCES 






















O 






DMKCST 


DMKCSO 


DMKCSY 


DMKDEF 


DMKDIA 


DMKDRD 


DMKLNK 


DMKMCD 


DMKMSG 


DMKNES 


DMKNET 


DMKNLD 


0) 

cr 






DMKNLE 


DMKPGS 


DMKQCN 


DBKRSE 


DMKSNC 


DMKSSS 


DHKTAP 


DMKTCS 


DMKTHI 


DMKTRC 


DMKTRD 


DMKTRK 






DMKOSO 


DMKVCA 


DMKVCH 


DMKVDD 


DMKVDR 


DMKVDS 


DMKVER 


DMKHRM 










M 


SAVENRK5 


000248 


DMKATS 


DMKCCH 


DMKCDB 


DMKCDM 


DMKCDS 


DMKCFD 


DMKCFG 


DMKCFH 


DMKCFO 


DMKCFS 


DMKCKS 


DMKCPB 


i 






DMKCPO 


DMKCQG 


DMKCQH 


DMKCQP 


DMKCQY 


DMKCSC 


DMKCSP 


DMKCSQ 


DMKCST 


DMKCSO 


DMKCSV 


DMKDEF 


EX 
O 






DHKDIA 


DMKDRD 


DMKLNK 


DMKNES 


DMKNET 


DMKNLD 


DMKNLE 


DMKPGS 


DMKSEP 


DMKSNC 


DMKSSS 


DMKTCS 






DMKTRC 


DMKTRK 


DMKONT 


DMKVCH 


DMKVDA 


DMKVDC 


DMKVDD 


DMKVIR 


DMKVMC 








SAVEWRK6 


000242 


DMKACO 


DMKATS 


DMKCCH 


EHKCDB 


DMKCDM 


DMKCFG 


DMKCFH 


DMKCFM 


DMKCFP 


DMKCFS 


DMKCKS 


DMKCPS 


Qj 






DHKCP0 


DMKCQG 


DMKCQP 


DMKCQY 


DMKCSB 


DMKCSC 


DMKCSP 


DMKCSQ 


DMKCST 


DMKCSU 


DMKCSV 


DMKDEF 


C 






DMKDIA 


DMKDRD 


DMKLNK 


EHKLOG 


DMKMCD 


DHKHSG 


DMKNLD 


DMKNLE 


DMKPGS 


DMKPTR 


DMKRSE 


DMKSNC 


(0 






DMKSSS 


DMKTCS 


DMKTHI 


DMKTRC 


DMKTRD 


DMKTRK 


DMKONT 


DMKVCA 


DMKVCH 


DMKVDA 


DMKVDC 


DMKVDD 








DMKVDR 


DMKVDS 


DMKVMC 


DMKVSP 


DMKHRM 
















O 
M 

o 


SAVEHRK7 


000145 


DMKACO 


DMKCCH 


DMKCFD 


DMKCFG 


DMKCFH 


DMKCFC 


DMKCFS 


DMKCKS 


DMKCPS 


DMKCPO 


DMKCQG 


DMKCQH 






DMKCQP 


DMKCQY 


DMKCSB 


DMKCSO 


DMKCSP 


DMKCST 


DMKCSO 


DMKCSV 


DMKDEF 


DMKDIA 


DMKIOG 


DMKLNK 


(A 






DMKNES 


DMKHET 


DNKNLD 


DMKNLE 


DMKPGS 


DMKSEE 


DMKSSS 


DMKTCS 


DMKTRA 


DMKTRC 


DMKTRD 


DMKTRK 


Ui 






DMKVDA 


DMKVDC 


DMKVDD 


DMKVDS 


DMKVER 


DMKVMC 


DMKHRM 












ta 


SAVEHRK8 


000304 


DMKACO 


DMKALG 


DMKATS 


DMKCCH 


DMKCDB 


DMKCDB 


DMKCDS 


DMKCFO 


DMKCFP 


DMKCFS 


DMKCKS 


DMKCPS 


(0 






DMKCPO 


DMKCPV 


DMKCQG 


DMKCQH 


DMKCQP 


DMKCQR 


DMKCSB 


DMKCSO 


DMKCSP 


DMKCSQ 


DMKCST 


DMKCSO 


(D 






DMKCSY 


DMKDEF 


DMKDIA 


DMKLNK 


DMKLOG 


DHKLOH 


DMKHSG 


DMKNES 


DMKNET 


DMKNLD 


DMKNLE 


DMKPTR 


M 






DMKSEP 


DMKSHC 


DMKSPL 


DMKSSS 


DMKTCS 


DMKTRC 


DMKTRD 


DMKTRK 


DMKVCH 


DMKVDA 


DMKVDC 


DMKVDD 


(D 






DMKYER 


DMKHRM 
























o 


SAVEHRK9 


000188 


DMKACO 


DMKATS 


DMKBLD 


DMKCCH 


DMKCCH 


DMKCFG 


DMKCFH 


DMKCKS 


DMKCPS 


DMKCPO 


DMKCQY 


DMKCSP 


(0 






DMKCSQ 


DMKCSY 


DMKDEF 


DMKDGD 


DHKDIA 


DMKEIG 


DMKLNK 


DMKLOG 


DMKLOH 


DMKNES 


DMKNET 


DMKNLD 








DMKNLE 


DMKPGS 


DMKPTR 


DMKSEP 


DMKSEV 


DMKSIX 


DMKSNC 


DMKTCS 


DMKTRC 


DMKTRD 


DMKONT 


DMKVCA 








DMKVCH 


DMKVDA 


DMKVDC 


DMKVDD 


DMKVDR 


DMKVDS 


DMKVER 














SAVFPRES 


000002 


DMKCFG 


DMKCFH 
























SAYGREGS 


000003 


DMKCFG 


DMKCFH 
























SAVKEYS 


000002 


DMKCFG 


DMKCFH 
























SAVPSH 


000002 


DMKCFG 


DMKCFH 
























SAYTABLE 


000002 


DMKCFG 


DMKCFH 
























SBA 


000115 


DMKDDR 


DMKDIR 


DMKFMT 


DHKGRF 


DMKGRT 


DHKGRH 


DMKOPR 


DHKRGA 


DMKRGB 


DMKSSP 








SCHEDCL 


000001 


DMKMCC 


























SDRBLOK 


000012 


DMKIOE 


DMKIOF 
























SDRBSIZE 


000001 


DMKIOE 


























SDRCTRS 


000014 


DMKIOE 


DMKIOF 
























SDRCOA 


000002 


DMKIOF 


























SDRFLAGS 


000005 


DMKIOE 


DMKIOF 
























SDRFLCT 


000004 


DMKIOF 


























SDRLHGTH 


000009 


DMKIOE 


DMKIOF 
























SDRMAX 


000003 


DMKIOF 


























SDROYFWK 


000006 


DMKIOF 


























SDRPRMCT 


000004 


DMKIOF 


























SDRRDEY 


000002 


DMKIOF 


























SDRRECD 


000004 


DMKIOF 


























SDRSHRT 


000007 


DMKIOE 


DMKIOF 
























SDRSIZE 


000001 


DMKIOF 





























LABEL 


COUNT 


REFERENCES 


























SDRSIZE1 


000001 


DMKIOF 




























SEARCH 


000002 


DMKCFC 


DMKVMI 


























SEEK 


000020 


DMKCKP 


DMKDAS 


DMKDMP 


DMKSPL 


DMKTDK 


DMKVMI 


















SEEKADR 


000006 


DMKDAS 




























SEEKCL 


000001 


DMKIOS 




























SEGENQ 


000002 


DMKBLD 




























SEGINV 


000028 


DHKATS 


DMKBLD 


DMKCFG 


DMKCFH 


DMKPGS 


DMKPTB 


DMKVMA 
















SEGPA6E 


000072 


DMKATS 


DMKBLD 


DMKCFG 


EMKCPI 


DMKPGS 


DMKPTR 


DMKVMA 
















SEGPLEN 


000006 


DHKBLD 


DMKVMA 


























SEGTABLE 


000014 


DMKATS 


DMKBLD 


DMKPGS 


DMKVMA 






















SENSE 


000077 


DMKDDR 


DMKDIR 


DMKDMP 


DMKEXT 


DMKFMT 


DMKSSE 


DMKVMI 


DMKVSP 














SETUP 


000011 


DMKACO 


DMKCKP 


DMKCPI 


DMKDSP 






















SET0P1 


000002 


DMKACO 


DMKCKP 


























SETDP2 


000002 


DMKACO 


DMKCKP 


























SF 


000097 


DMKDDR 


DMKDIR 


DMKFMT 


DHKGRF 


DMKGRT 


DHKGRW 


DMKOPR 


DMKRGA 


DMKRGE 


DMKSSP 










SFBCLAS 


000030 


DMKCKP 
DMKSPL 


DMKCQH 
DMKVSP 


DMKCQR 
DMKVSQ 


DMKCSP 


DMKCSQ 


DHKCSU 


DMKCSV 


DMKDRD 


DMKMIA 


DMKNLE 


DMKRSP 


DMKSEP 






SFBCOPY 


000027 


DMKCKP 


DMKCKS 


DMKCQH 


DMKCSO 


DMKCSU 


DMKDRD 


DMKMIA 


DMKNLE 


DMKRSP 


DMKSPL 


DMKTCS 








SFBDATE 


000013 


DMKCKP 


DMKCQH 


DMKDMP 


DMKMIA 


DMKNLE 


DMKSEE 


DMKSPL 


DMKWRM 














SFBDIST 


000035 


DMKCKP 


DMKCKS 


DMKCQH 


DMKCSQ 


DMKCSU 


DMKMIA 


DMKNLE 


DMKSEP 


DMKSPL 












SFBDUMP 


000008 


DMKCKS 


DMKCQH 


DMKDMP 


EMKDRD 


DMKNLE 


DMKSPL 


DMKVSP 
















SFBEOF 


000014 


DMKCKS 


DMKDRD 


DMKVSP 


DMKWRH 


















O 




SFBFILID 


000046 


DMKCKP 


DMKCKS 


DMKCQH 


DMKCSP 


DMKCSQ 


DMKCST 


DMKCSU 


DMKCSV 


DMKDMP 


DMKDRD 


DMKMIA 


DMKNNI 


*xi 








DMKNLE 


DMKRSE 


DMKRSP 


DMKSEP 


DMKSPL 


DMKTCS 


DMKVSP 


DMKVSQ 


DMKWRM 












SFBFIRST 


000002 


DMKCKP 


DMKSPL 
























SFBFLAG 


000101 


DMKCKP 
DMKRSP 


DMKCKS 
DMKSPL 


DMKCQH 
DMKUSO 


DMKCQR 
DMKVSP 


DMKCSO 
DMKVSQ 


DMKCSP 
DMKWRM 


DMKCSQ 


DMKCSU 


DMKCSV 


DMKDRD 


DMKNLE 


DMKRSE 


CD 




SFBFLAG2 


000047 


DMKCKP 


DMKCKS 


DMKCSO 


DMKCSQ 


DMKDRD 


DMKMIA 


DMKRSP 


DMKSEP 


DMKSPL 


DMKVSP 


DMKVSQ 


DMKWRH 


7 




SFBFLASH 


000007 


DMKCQH 


DMKCSU 


DMKRSP 


DMKSPL 


















rt 
a 
I 


o 


SFBFLNMT 


000002 


DMKVSP 


DMKVSQ 






















*0 


SFBFNAME 


000015 


DMKCKP 


DMKCQH 


DMKCSQ 


DMKCSU 


DMKMIA 


DMKNLE 


DMKRSP 


DMKSEP 


DMKSPL 


DMKWRM 






06 


O 


SFBFTYPE 


000009 


DMKCKP 


DMKCQH 


DMKMIA 


DMKNLE 


DMKRSP 


DMKWRM 














o 

Pi 

a 


H" 


SFBHOLD 


000011 


DMKCSQ 


DMKSPL 


DMKVSP 




















CD 
O 


SFBINUSE 


000018 


DMKCKS 


DMKCQH 


DMKCQR 


DMKCSP 


DMKCSQ 


DMKCSU 


DMKCSV 


DMKDRD 


DMKRSP 


DMKUSO 


DMKVSP 


DMKWRM 


M 


SFBLAST 


000055 


DMKCKP 


DMKCKS 


DMKDMP 


DMKDRD 


DMKMIA 


DMKNLE 


DMKRSP 


DMKSPL 


DMKVSP 


DMKVSQ 






CD 


ft 


SFBLOK 


000085 


DMKCKP 


DMKCKS 


DMKCPI 


DMKCQH 


DMKCQR 


DMKCSC 


DMKCSP 


DMKCSQ 


DMKCST 


DMKCSU 


DMKCSV 


DHKDHP 


n 


o 

l-J 






DMKDRD 


DMKMIA 


DMKHNI 


DMKNLE 


DMKRSE 


DMKRSP 


DMKSEP 


DMKSPL 


DMKTCS 


DMKUSO 


DMKVSP 


DMKVSQ 


o 

W 


H« 






DMKWRM 
























CD 

w 


SFBMISC1 


000003 


DMKVSQ 
























tfl 


SFBMON 


000007 


DMKCKS 


DMKDRD 


DMKMIA 


DMKSPL 


DMKVSP 
















<t> 




SFBNOHLD 


000010 


DMKCSQ 


DMKSPL 


DMKVSP 






















SFBOPEN 


000007 


DMKCKS 


DMKDRD 


DMKVSP 


DMKWRM 


















M) 


_» 


SFBORIG 


000013 


DMKCKP 


DMKCPI 


DMKCQH 


EMKCSV 


DMKMIA 


DMKNLE 


DMKRSP 


DMKSEP 


DMKSPL 








CD 


l 


SFBPNT 


000083 


DMKCKP 


DMKCKS 


DMKCQH 


DMKCQR 


DMKCST 


DHKCSV 


DMKDMP 


DMKDRD 


DMKMIA 


DMKNLE 


DMKRSE 


DMKRSP 


(D 








DMKSPL 


DMKVSP 


DMKVSQ 


DMKWRM 


















o 


yi 


SFBPURGE 


000011 


DMKCKP 


DMKSPL 


DMKVSP 


DMKVSQ 



















1 


LABEL 


C00MT 


REFERENCES 


















0\ 


SFBRECER 


000033 


DMKCKP 


DMKCKS 


DMKCSO 


DMKDRD 


DHKRSE 


DMKRSP 


DMKSFL 


DMKVSP 


DMKVSQ DHKWRM 






SFBRECNO 


000028 


DMKCKS 


DMKCQR 


DMKMIA 


DMKNLE 


DMKRSP 


DMKSEE 


DMKSPL 


DMKVSP 


DMKVSQ 




M 


SFBRECOK 


000003 


DMKCSO 


DMKRSP 


















CO 

ac 


SFBRECS 
SFBRECSZ 


000019 
000006 


DMKCKP 
DHKNLE 


DMKCKS 
DMKSPL 


DMKRSP 
DMKVSP 


DMKSPL 


DMKVSP 


DMKHRH 










SB 


SFBREQOE 


000007 


DBKCSO 


DMKRSP 


DMKSPL 
















\ 


SFBRSTRT 


000008 


DMKCKS 


DMKRSP 


DMKSEP 


DMKSPL 


DMKHRM 












U> 


SFBSHOLD 


000019 


DMKCQH 


DMKCQR 


DMKCSO 


DMKCSQ 


DMKCSU 


DMKRSE 


DMKRSP 


DMKSPL 






o 


SFBSIZE 


000040 


DMKCKP 


DMKCKS 


DMKDMP 


DMKDRD 


DMKMIA 


DMKHLE 


DMKRSP 


DMKSPL 


DMKUSO DHKWRM 






SFBSTART 


000081 


DMKCKP 


DMKCKS 


DMKCPI 


DMKCQH 


DMKCST 


DMKCSU 


DMKDMP 


DMKDRD 


DMKMIA DMKNLE DMKRSP DMKSPL 


CO 






DMKTCS 


DMKVSP 


DMKVSQ 
















SFBSTCPY 


000004 


DMKSPL 


DMKTCS 


















1+ 


SFBTICER 


000001 


DMKRSP 




















B 


SFBTIME 


000014 


DMKCKS 


DMKCQH 


DMKDMP 


DMKMIA 


DMKHLE 


DMKSEP 


DMKSPL 


DMKVSP 


DMKVSQ 




SFBTYPE 


000015 


DMKCQH 


DHKDMP 


DMKDRD 


EMKMIA 


DMKHLE 


DMKRSE 


DMKSPL 


DMKVSQ 






f* 


SFB0HOLD 


000019 


DMKCKS 


DMKCQH 


DMKCQR 


DMKCSP 


DMKCSU 


DMKDRD 


DMKRSP 


DMKSPL 


DMKVSP 




o 


SFBOSER 


000046 


DMKCKP 


DMKCPI 


DMKCQH 


DMKCQR 


DMKCSP 


DMKCSC. 


DMKCST 


DMKCSU 


DMKCSV DMKDRD DMKMIA DMKNLE 


p. 






DMKRSP 


DMKSEP 


DMKSPL 


DMKTCS 


DMKVSP 












O 


SHQBLOK 


000011 


DMKCKS 


DMKCQR 


DMKCSQ 


DMKSPL 


DMKflRM 












D> 


SHQBSIZE 


000012 


DMKCKP 


DMKCKS 


DMKCSQ 


DHKWRM 














3 


SHQ FLAGS 


000001 


DMKCSQ 




















Oi 


SHQPNT 


000001 


DMKCSQ 




















•O 


SHQSHOLD 


000005 


DMKCQR 


DMKCSQ 


DMKSPL 
















M 


SHQOSER 


00000.7 


DMKCKS 


DMKCQR 


DMKCSQ 


DMKSPL 














O 


SHRBPNT 


000007 


DMKATS 


DMKCFG 


DMKCFH 


DMKPGS 














M 


SHRFLAG 


000016 


DMKATS 


DMKCFG 


DMKCPU 


DMKPGS 


DMKPTR 












n> 


SHRFPNT 


000022 


DMKATS 


DMKCFG 


DMKCFH 


DMKCPU 


DMKPGS 












B 


SHRLKCNT 


000012 


DMKCCW 


DMKDGD 


















O 


SHRNAME 


000017 


DMKATS 


DMKCFG 


DMKCFH 


DMKCPU 


DMKPGS 


DMKVMA 










c+ 
(D 


SHRNOPRT 


000016 


DMKATS 


DMKCFG 


DMKCPU 


DMKPGS 


DMKPTR 












SHRPAGE 


000025 


DMKATS 


DMKCDS 


DMKCFG 


DMKCPU 














M 


SHRSEGCT 


000019 


DMKATS 


DMKCFG 


DMKCPU 


DMKPGS 


DMKPTR 


DMKVMA 










B 
H* 


SHRSEGNH 


000016 


DMKATS 


DMKCFG 


DMKCPU 


DMKPGS 


DMKVMA 












9 


SHRTABLE 


000032 


DMKATS 


DMKCFG 


DMKCFH 


DMKCPU 


DMKPGS 


DMKPTR 


DMKVMA 








PI 


SHRTSIZE 


000003 


DMKATS 


DMKCFG 


DMKPGS 
















f+ 


SHROSECT 


000009 


DMKATS 


DMKCFG 


DMKPGS 
















O 


SIGAPR 


000001 


DHKMCT 




















9 
1 
1 


SIGCLK 
SIGDISP 


000001 
000001 


DMKCLK 
DMKDSP 




















< 


SIGEHS 


000010 


DMKACO 


DMKCLK 


DMKCPS 


DMKCPU 


DMKEXT 


DMKPTR 










o 


SIGEXT 


000001 


DMKPTR 




















CS 


SIGIPR 


000003 


DMKCPI 


DMKCPU 


















B 
(0 


SIGMASK 


000001 


DMKDSP 




















SIGQDI 


000005 


DMKACO 


DMKCLK 


DMKCPS 


DMKCPU 


DMKPTR 












-A 


SIGBES 
SIGBEST 


000004 
000004 


DMKACO 
DMKAPI 


DMKCLK 
DMKDMP 


DMKPTR 
DMKMCT 

















o 

*n 

t- 1 
o> 
tr 

(0 

I 

rt 
O 

I 

E3 

o 

c 

M 
(0 

n 
ii 
o 

01 

w 

(D 
H» 
(D 
H 
(D 
P 

n 

(0 





LABEL 


COUNT 


REFERENCES 


























SIGSAVE 


000006 


DBKEXT 




























SIGSENSE 


000005 


DBKCPI 


DBKCPU 


DBKDBP 


DBKEXT 






















SIGSHD 


000001 


DBKCPS 




























SIGSSS 


000005 


DBKDBP 


DBKBCT 


























SIGSTART 


000002 


DBKBCH 




























SIGSTOP 


000004 


DBKCP0 


DBKDBP 


DBKBCH 


DBKBCT 






















SIGSYNC 


000001 


DBKCLK 




























SIGNAKE 


000010 


DBKCPI 


DBKCPD 


DBKDSP 


DBKFRE 


DBKIOS 


DBKSCH 


















SIGXC 


000017 


DBKACO 


DBKCLK 


DBKCPI 


DBKCPO 


DBKDSP 


DBKEXT 


DBKFRE 


DBKICS 


DBKBCT 


DBKPTR 


DHKSCH 








SILI 


001230 


DBKACO 


DBKBSC 


DBKCCH 


DBKCFP 


DBKCKP 


DHKCNS 


DHKCPB 


DBKCPI 


DBKCSE 


DHKDAS 


DHKDDR 


DBKDGD 










DBKDIB 


DBKDIR 


DBKDHP 


DBKDSB 


DBKFBT 


DBKGRF 


DHKGRT 


DBKGHH 


DBKIOS 


DBKLDOOE 


DHKBCC 


DBKNLD 










DBKNLE 


DBKOPR 


DBKPAG 


DBKRGA 


DBKRGB 


DBKRNH 


DBKRSE 


DBKRSP 


DBKSAV 


DBKSEP 


DBKSPL 


DBKSSP 










DBKTAP 


DBKTCS 


DBKTDK 


DBKTRK 


DBKOCB 


DHKOCC 


DBKOCS 


DHKODR 


DBKVCA 


DBKVCN 


EBKVDE 


DHKVDR 










DBK7BI 


DBKVSP 


DBKVSQ 


DHKWRB 






















SIOCCH 


000002 


DBKCCH 




























SIZE 


000024 


DBKCKP 


DBKFRE 


DBKLDOOE 
























SKIP 


000162 


DBKACO 


DBKCCW 


DHKCKP 


DHKCNS 


DBKCSB 


DBKCST 


DBKDAS 


DBKEDB 


DHKDIE 


EBKDIR 


DBKDBP 


DHKDRD 










DBKFBT 


DBKIOS 


DBKPAG 


DHKRSE 


DBKRSP 


DBKSAV 


DBKSEP 


DBKSPL 


DHKTAP 


DBKTCS 


DBKTRK 


DHKONT 










DHKVCA 


DHKVCN 


DBKVDE 


DBKVBI 


DHKVSI 


DBKVSP 


















SB 


000031 


DBKCNS 


DBKCPI 


DBKDBP 


DHKFBT 


DBKIOS 


DHKMLD 


DBKNLE 


DHKPSA 


DBKRSE 


BBKSSP 


DBKVHI 


DHKVSI 






SPCHAR 


000012 


DBKCQH 


DBKCSO 


DBKSPL 


DBKTCS 






















SPCBOD 


000008 


DBKCQH 


DBKCSO 


DBKSPL 


EHKTCS 


















O 




SPCOPYFG 


000007 


DBKCQH 


DBKCSO 


DHKSPL 


DBKTCS 


















►O 




SPEC 


000082 


DBKLD00E 
























f» 




SPENDSIZ 


000002 


DBKSPL 
























P> 




SPFCB 


000008 


DBKCQH 


DBKCSO 


DBKSPL 


DHKTCS 






















SPPILID 


000004 


DBKCKS 


DBKVSP 


DBKVSQ 






















SPFLAG1 


000005 


DBKCQH 


DBKCSO 


DBKSPL 


DBKTCS 


















I 




SPFLSHC 


000005 


DBKCQH 


DBKCSO 


DBKSPL 


DHKTCS 


















O 

I 


n 


SPLINK 


000015 


DBKCKS 


DBKCQH 


DBKCSO 


DBKDRD 


DBKHIA 


DBKRSP 


DBKSPL 


DHKTCS 


DBKVSP 


BBKVSQ 






HJ 


SPHXTPAG 


000029 


DBKCKS 


DHKDRD 


DHKBIA 


DBKRSP 


DBKVSP 


DBKVSC 














at 


a 


SPOOLED 


000035 


DBKCPS 


DBKDBP 


DBKBCC 


DMKBCD 


DBKBIA 


DHKHNI 


DBKBON 












o 


H- 


SPPREPAG 


000018 


DBKCKS 


DBKDRD 


DBKBIA 


DBKRSP 


DBKVSP 


DBKVSQ 



















SPRECNOB 


000017 


DBKCKS 


DBKBIA 


DBKRSP 


DBKVSP 


DBKVSQ 


















O 


SPRHISC 


000002 


DBKRSP 
























O 


SPROFCL 


000003 


DBKBCC 


DHKBOH 






















O 


SPSIZE 


000014 


DBKRSP 


DBKSPL 


DBKVSP 


DHKVSQ 


















o 


H* 


SPTIBE 


000004 


DBKCKS 


DBKVSP 


DHKVSQ 




















01 


SSA?E 


000004 


DBKIBG 
























W 


STACKYB 


000012 


DBKCPO 


DBKDSP 


DHKOSO 




















CO 




START 


000037 


DBKACO 


DBKAPI 


DHKBLD 


EHKCFC 


DBKCPO 


DBKDIA 


DBKDSP 


DBKEBE 


DHKFBT 


DBKIOS 


DHKLDOOE 


DHKLOG 


a> 








DHKBCD 


DBKBCH 


DHKHCT 


DBKPRG 


DHKPSA 


DBKSAV 


DBKSCH 


DflKSVC 


DHKOSO 








hh 


1 


STARTIBE 
STCODE 


000013 
000004 


DBKBLD 
DBKACO 


DHKCKP 
DHKCKP 


DBKCPI 


EHKCQR 


DHKWRB 


















U) 


STOP 


000026 


DBKACO 


DBKBLD 


DBKCPO 


DHKDSP 


DBKEXT 


DBKBCH 


DBKBCT 


DBKBNI 


DBKPRG 


DHKSCH 


DHKSVC 




p 
o 
a> 


-J 


STRTADDR 


000001 


DBKIBG 

























1 


LABEL 


COUNT 


REFERENCES 














O 


-J 

00 


SUSPEND 


000015 


DMKCFP 


DMKCKP 


DMKMIA 


DMKMNI 


DMKHON 












SVCNPSW 


000014 


DMKAPI 


DMKCPI 


DMKPRG 


EMKSVC 


DMKTRC 








(D 


H 


SVCOPSW 


000037 


DMKPRG 


DMKSVC 


DMKTRC 












M 


M 

EX 


SVCREGS 
SVHN0DPD 


000013 
000002 


DHKSVC 
DMKCFO 


DMKLOK 














1 

c+ 
O 


DC 


SVHSTAY 


000017 


DMKCNS 


DMKGRF 


DMKLOK 


DMKHES 


DMKNLD 


DMKRGA 


DHKRGB 


DMKRNH DMKSPL 


1 

DC 


SVMUNL0K 


000007 


DHKCN5 


DMKCPV 


DMKLOK 


CMKRGA 


DMKRNH 


DMKSPL 






O 


U) 


SWP ALLOC 


000013 


DMKATS 


DMKPGS 


DMKPTR 












Oi 


-J 

Q 


SWPAPP 


000005 


DMKATS 


DMKCFG 


DMKPTR 












fl> 




SWPCHG1 


000012 


DMKATS 


DMKCFG 


DMKCPI 


DMKCPU 


DMKMCH 


DMKPTB 


DMKRPA 




en 


SWPCHG2 


000006 


DMKMCH 


DMKPTR 


DMKRPA 












n 


SWPCODE 


000007 


DMKATS 


DMKCPU 


DMKPAG 


DMKPGS 


DMKPTR 








r+ 


SWPCYL 


000016 


DMKATS 


DMKCDS 


DMKCFG 


DMKCPI 


DMKCPU 


DMKPAG 


DMKPGS 


DMKPGT DMKPTR DMKRPA DMKUDU 


o 


(0 


SWPDPAGE 


000008 


DHKPAG 


DMKPGT 


DMKPTR 












VI 


B 


SWPFLAG 


000133 


DMKATS 


DMKBLD 


DMKCCW 


DMKCDS 


DMKCFG 


DMKCFH 


DMKCPI 


DMKCPU DMKDGD DMKMCH DMKPAG DMKPGS Ui 


f< 






DMKPGT 


DMKPRV 


DMKPTR 


EMKRPA 


DMKUDU 


DMKVAT 


DMKVMA 




SO 


O 


SWPFLAG2 


000005 


DMKATS 


DMKCFG 


DMKPTR 












(0 
Mi 


SHPKEY1 


000018 


DMKATS 


DMKCFG 


DMKCFH 


DMKMCH 


DMKPGS 


DMKPRV 


DMKPTR 




o 


SWPKEY2 


000006 


DMKMCH 


DMKPTR 














n 


p> 


SWPPAG 


000004 


DMKATS 


DMKBLD 


DMKCFG 












(D 

C3 


9 


SWPRECMP 


000026 


DMKATS 


DMKBLD 


DMKCDS 


DMKCPU 


DMKPAG 


DMKPGS 


DMKPGT 


DMKPTR DMKRPA DMKUDU 


O 


Oi 


SWPREF1 


000004 


DMKPTR 
















CD 


T} 


SWPREF2 


000005 


DMKPTR 


















H 


SWPSHR 


000012 


DMKATS 


DMKCFG 


DMKPGS 


DMKPRV 


DMKPTR 


DMKRPA 


DMKVAT 






O 


SWPTABLE 


000040 


DMKATS 


DMKBLD 


DMKCFG 


DMKCPU 


DMKPGS 


DMKPTR 


DMKVAT 


DMKVMA 




SWPTRANS 


000016 


DMKCDS 


DMKPAG 


DMKPGS 


DMKPTR 


DMKRPA 


DMKVMA 








m 


SWPVM 


000016 


DMKATS 


DMKBLD 


DMKCFG 


DMKCPU 


DMKPGS 










9 


SWPVPAGE 


000009 


DMKATS 


DMKPTR 


DMKVMA 














O 


SWTCH 


000013 


DMKMCH 


DMKMCT 
















a> 


SWTHSAVE 


000010 


DMKSTK 


DMKVMA 
















SYNCL0G 


000001 


DMKCPI 


















n 


SYNCHASK 


000002 


DMKCLK 


DMKEXT 



















SYSCYL 


000002 


DMKCFG 


DMKCFH 
















B 


SYSFLAG 


000003 


DMKCFG 


















0) 


SYSHRSEG 


000006 


DMKCFG 


DMKCPU 


















SYSIPLDV 


000009 


DMKCKS 


DMKCPI 


DMKHVD 


DMKIOG 


DMKNRM 










O 


SYSLOCS 


000021 


DMKACO 


DMKBLD 


DMKCFO 


EMKCFT 


DHKCKP 


DHKLOC 


DHKLOG 


DMKLCH DMKUDR DMKUDU DMKUSO 




a 
l 
( 


SYSNAME 
SYSPAGCT 


000011 
000003 


DMKATS 
DMKCFG 


DMKCFG 
DMKCFH 


DMKCFH 


DMKCPU 












<J 


SYSPAGLN 


000012 


DMKATS 


DMKCFG 


DMKCFH 


DMKCPU 












o 


SYSPAGMN 


000022 


DMKATS 


DMKCFG 


DMKCFH 


DMKCPU 












(3 


SYSPHT 


000005 


DMKATS 


DMKCFG 


DMKCFH 


DMKCPU 












S 
(0 


SYSPROT 


000003 


DMKCFG 


















SYSSEGLN 


000004 


DMKCFG 


















— * 


SYSSIZE 


000002 


DMKCFG 


DMKCFH 


















SYSSTART 


000004 


DMKATS 


DMKCFG 


DMKCFH 


DMKCPU 















LABEL 


COONT 


REFEREHC1 


ES 


























SYSTBL 


000005 


DBKATS 


DBKCFG 


DBKCFH 


DBKCPO 






















SYSTEB 


000318 


DBKAPI 


DBKATS 


DBKCFC 


DBKCFG 


DBKCFH 


DHKCKS 


DBKCHS 


DBKCPE 


DBKCPI 


DBKCPS 


DHKCPO 


DBKCPV 










DBKCQH 


DBKCSB 


DBKCSO 


DBKCST 


DBKCSO 


DHKDRD 


DBKEBC 


DBKERB 


DBKGRF 


DBKGRT 


DBKHVD 


DBKIOF 










DMKIOG 


DBKBCC 


DBKBIA 


DHKBON 


DBKNLD 


DHOLE 


DBKPTR 


DBKRGA 


DBKRGE 


DBKRNH 


DHKRPA 


DHKRSP 










DHKSEP 


DBKSNC 


DBKSPL 


DBKSSP 


DBKSVC 


DBKTCS 


DBKDDR 


DBKOBD 


DBKVCH 


DHKVDR 


DBKVSP 


DBKVSQ 










DBKWRB 




























SYSTEBID 


000006 


DHKVBC 




























SYSVADDR 


000006 


DBKCFG 


DBKCFH 


























SYSVIHT 


000033 


DBKCCW 


DBKCFP 


DBKCQP 


DBKDEF 


DBKDGD 


DHKDSE 


DBKIOS 


DNKLNK 


DHKLOG 


DBKSSS 


DBKVDA 


DBKVSI 






SYSVOL 


000008 


DBKATS 


DBKCFG 


DBKCFH 


DBKCPU 






















TABEND 


000002 


DBKRGA 




























TAG 


000003 


DBKCST 




























TAPE 


000004 


DBKCCW 


DBKDDR 


DBKVDC 


DBKVBI 






















TBLCT 


000007 


DBKLDOOE 




























TBLREF 


000007 


DBKLDOOE 




























TEBPRO 


000059 


DBKAPI 


DBKATS 


DBKCNS 


DBKCPI 


DBKDSP 


DBKPTR 


DBKRGA 


DBKVCA 


DBKVBA 


DBKVSP 










TEBPR1 


000014 


DBKCQP 


DBKPGS 


DBKPTR 


DBKSCH 


DHKVSP 




















TEBPR10 


000002 


DBKCCW 




























TEBPR11 


000002 


DBKATS 




























TEBPR12 


000002 


DBKPRS 




























TEBPR14 


000028 


DBKCCW 


DBKCDS 


DBKCPI 


DBKPRG 


DBKSCH 




















TEBPR15 


000008 


DBKCCW 


DBKCDS 


DBKCPI 


DBKPRG 


DBKSCH 
















O 




TEBPR2 


000029 


DBKAPI 


DBKATS 


DBKCCW 


DBKCPI 


DHKCSP 


DBKCSO 


DBKCSV 


DBKPGS 


DBKPTR 


DBKSAV 


DBKVCA 


DBKVBA 


*x) 




TEHPR3 


000016 


DBKAPI 


DBKCCW 


DBKCPI 


DBKCSO 


DBKCSV 


DBKRGE 


DBKVCA 












ft 




TEBPR4 


000011 


DBKAPI 


DBKCPI 


DBKCSU 


DBKCSV 


DBKSAV 


DBKSCH 


DBKVCA 












P> 




TEBPR5 


000008 


DBKAPI 


DBKCPI 


DBKVCA 


DBKVBA 






















TEBPR6 


000006 


DBKHVC 


DBKVBA 
























TEBPR7 


000002 


DBKRGA 
























T 




TEMPR8 


000002 


DBKHVC 
























O 

1 


o 


TEBPR9 


000002 


DBKIOS 
























►d 


TEBPSAVE 


000173 


DBKAPI 


DBKCCW 


DBKCFS 


DBKCHS 


DBKCPI 


DHKCQR 


DBKCVT 


DBKDSP 


DBKFRE 


DBKGRF 


DBKIOS 


DHKLOG 


□6 


O 






DBKBID 


DBKNET 


DBKNLD 


DHKPRV 


DBKPSA 


DBKQCN 


DBKRNH 


DBKSAV 


DBKSCH 


DBKSSS 


DHKVIO 


DBKVSI 


O 

Pi 


H« 


TEBPST 


000007 


DBKLDOOE 
























C 


(0 
O 


TERBSYS 


000009 


DBKCCH 


DBKEIG 


DBKSEV 


DBKSIX 




















TESTCON 


000001 


DBKDDR 
























(+ 


TEXT 


000011 


DBKIBG 


DNKNBT 


DBKRND 




















o 


o 


TEXTA 


000002 


DBKDDR 


DBKDIR 






















M 
O 
W 


H- 


TIC 


000008 


DBKSSP 


DBKTAP 


DBKTDK 


DBKVCN 


DBKVBI 


DHKVSP 














C/) 


TIBEDISP 


000180 


DBKACO 


DBKALG 


DBKAPI 


1DBKBLD 


DBKCFO 


DHKCFE 


DBKCNS 


DBKCPI 


DHKCPS 


DBKCPU 


DBKCPV 


DBKCSO 


0) 






DBKCSV 


DBKDIA 


DBKDSP 


DBKEXT 


DBKGRF 


DBKIOE 


DBKIOS 


DBKJRL 


DBKLOG 


DBKLOH 


DBKLOK 


DHKBCH 


W 








DBKBCT 


DBKBIA 


DBKBID 


DMKBSG 


DBKBSW 


DHKNES 


DBKHLD 


DBKPSG 


DBKPRG 


DBKPSA 


DBKPTR 


DHKQCN 


(t> 








DBKRGA 


DBKRGB 


DBKRNH 


DBKSCH 


DBKSPL 


DBKSVC 


DBKTCS 


DBKOSO 


DBKVCA 


DBKVCH 


DBKVDA 


DBKVDD 


l-h 
(T> 


_* 






DBKVBC 


DBKVSI 






















1 


TIBER 


000036 


DBKAPI 


DBKCFS 


DBKCPI 


DBKDDR 


DBKDIR 


DBKDSE 


DHKEHE 


DBKEXT 


DBKIOS 


DBKHCH 


DBKPRG 


DBKPSA 


(D 


U> 






DBKPTR 


DBKSCH 


DBKSVC 


DHKTRA 


















P 
O 


VO 


TIOCCH 


000012 


DBKCCH 


DBKEIG 


DBKSEV 


DBKSIX 



















1 
u> 


LABBL 


COUNT 


REFERENCES 






















O 
*0 


00 

o 


TMPLOC 
TNSCPIDN 


000010 
000001 


DMKLD00E 
DMKIOF 
























f 

tr 


H 


TNSDEVAD 


000016 


DMKIOF 
























1 


td 

at 


TNSKEYN 
TMSRBC 


000002 
000003 


DMKIOF 
DMKIOF 
























O 


< 
at 


THSSNS1 


000005 


DMKIOF 
























1 

SB 


TNSSNS3 


000010 


DMKIOF 
























O 


u> 


TNSVOLID 


000002 


DMKIOF 
























c 

(-J 


-J 
o 


TODATE 


000022 


DMKACO 


DMKCKP 


DMKCPI 


DMKCVT 


DMKDDR 


DMKDHP 


DMKMCD 


DNKMIE 


DHKHNI 








TODSYNC 


000001 


DHKCLK 
























to 


CO 


T00BIG 


000001 


DHKHCD 
























o 


TRACBEF 


000003 


DMKCNS 


DMKIOS 


DMKVSI 




















<■+ 


TRACCOHR 


000065 


DMKCHS 


DMKCPI 


DMKDSP 


DMKEXT 


DMKFRE 


DMKIOS 


DMKLOK 


DMKMCC 


DMKMCB 


DMKPRG 


DMKPSA 


DMKRNH 


o 


<D 






DMKSCH 


DMKSVC 


DMKVSI 




















en 
en 


B 


TRACEFLG 


000008 


DMKCPI 


DMKMCC 


DMKMCD 


DMKHIA 


















t-i 


TRACEND 


000022 


DMKCNS 


DMKCPI 


DMKDSP 


DMKEXT 


DMKFRE 


DMKIOS 


DMKLOK 


DMKMCH 


DMKPRG 


DMKPSA 


DMKRNH 


DMKSCH 


so 


O 






DMKSVC 


DMKVSI 






















<t> 


TRACFLG1 


000011 


DMKFRE 


DMKIOS 


DMKMCH 


DMKPRG 


DMKPSA 


DMKSCH 


DMKSVC 












(D 


o 


TRACFLG2 


000014 


DMKCNS 


DMKDSP 


DMKEXT 


DMKIOS 


DMKLOK 


DMKRNH 


DMKVSI 












1-1 

D 


pi 


TRACPROC 


000023 


DMKAPI 


DMKCNS 


DMKCPI 


DMKDSP 


DMKEXT 


DMKFRE 


DMKIOS 


DMKLCK 


DMKMCH 


DMKMON 


DMKPRG 


DMKPSA 


a 






DMKRNH 


DMKSCH 


DMKSVC 


DMKVSI 


















O 


en 


TRACSTRT 


000027 


DMKAPI 


DMKCNS 


DMKCPI 


DHKCP0 


DMKDSP 


DMKEXT 


DMKFRE 


DMKIOS 


DMKLOK 


DMKMCC 


DMKMCH 


DMKPRG 


<D 


•rs 






DMKPSA 


DMKRNH 


DMKSCH 


DMKSVC 


DMKVSI 


















M 


TRACOA 


000001 


DMKDSP 


























o 
tr 


TRACOC 


000001 


DMKDSP 


























TRACOD 


000001 


DMKVSI 


























(D 


TRAC01 


000001 


DMKPSA 


























a 


TRAC02 


000002 


DMKSVC 


























o 


TRAC03 


000002 


DMKPRS 


























(D 


TRAC04 


000001 


DMKMCH 


























(0 


TRAC05 


000001 


DMKIOS 


























M 


TRAC08 


000001 


DMKSCH 


























a 


TRAC09 


000001 


DMKSCH 


























P 


TRAC10 


000001 


DMKDSP 


























P> 


TRAC11 


000001 


DMKRNH 


























«+ 
O 


TRAC12 


000001 


DMKLOK 


























TRAC13 


000005 


DMKEXT 


























a 


TRAC67 


000002 


DMKFRE 


























1 
j 


TRANMODE 


000024 


DMKCDS 


DMKCFG 


DHKCPB 


DMKDSP 


DMKMCH 


DMKPRG 


DMKPRV 


DMKSVC 


DMKTMR 


DMKTRC 


DMKTRD 


DMKVAT 




«* 






DMKVER 


























o 

H 


TRAP 


000004 


DMKHIA 


DMKMON 
























TRCCLCH 


000003 


DMKVSI 


























8 


TRCCSW 


000003 


DMKVSI 


























(D 


TRCDROP 


000003 


DMKSCH 


























_t 


TRCEXT 
TRCFREE 


000003 
000003 


DMKPSA 
DMKFRE 



























LABEL 



COUNT 



REFERENCES 



n 

O 
H* 
M 
(0 

o 

r* 
O 

n 
p* 
(P 
en 



I 
u> 

00 



TRCFRET 

TRCHALT 

TRCLOK 

TRCMCH 

TRCNCP 

TRCPGM 

TRCRUN 

TRCSCH 

TRCSIGP 

TRCSVC 

TRCONBLK 

TRCDNSTK 

TREXADD 

TREXANSI 

TSEXBRAN 

TREXBUFF 

TREXCCW 

TREXCR9 

TREXCSW 

TREXCTL 

TREXCTL1 

TREXCTL2 

TREXFLAG 

TREXINST 

TREXINTC 

TREXINTL 

TREXIN1 

TREXIN2 

TREXLCNT 

TREXLOCK 

TREXNDSP 

TREXNSI 

TREXPERA 

TREXPERC 

TREXPRNT 

TREXPSW 

TREXRUNF 

TREXSIZE 

TREXSVC1 

TREXSVC2 

TREXT 

TREXTERH 

TREXVAT 

TRQBBPNT 

TRQBFPNT 

TRQBIRA 



000003 
000003 
000003 
000003 
000003 
000006 
000001 
000003 
000003 
000006 
000001 
000001 
000004 
000006 
000013 
000008 
000006 
000004 
000006 
000004 
000003 
000009 
000012 
000013 
000004 
000001 
000012 
000009 
000006 
000001 
000008 
000012 
000003 
000001 
000005 
000002 
000006 
000006 
000003 
000003 
000023 
000008 
000005 
000007 
000025 
000014 



DBKFRE 
DHKVSI 
DNKLOK 
DMKMCH 
DHKRNH 
DHKPRG 
DMKDSP 
DMKSCH 
DMKEXT 
DMKSVC 
DMKDSP 
DMKDSP 
DHKPRG 
DMKPGS 
DHKTRA 
DMKTRC 
DMKTRA 
DMKDSP 
DMKTRA 
DMKTRA 
DMKTRC 
DMKTRC 
DMKDSP 
DMKTRA 
DMKPRG 
DMKPRG 
DMKDSP 
DMKDSP 
DMKTRC 
DMKCFM 
DMKDSP 
DMKPGS 
DMKPRG 
DMKPRG 
DMKTRA 
DMKPRG 
DMKTRA 
DMKTRA 
DMKTRC 
DMKTRC 
DMKCFM 
DMKCFM 
DMKTRC 
DMKPSA 
DMKCFP 
DMKBLD 



DMKVAT 
DMKTRA 
DMKTRC 
DMKTRD 
DMKTRD 
DMKPRV 
DMKTRC 

DMKTRD 
DMKTRD 
DMKPRV 
DMKTRC 
DMKPRV 



DMKTRC 

DMKTRC 
DMKTRC 
DMKTRD 
DMKTRD 
DMKDSP 
DMKTRA 
DMKTRD 
DMKSCH 
DMKCPO 
DMKCFC 



DMKTRC 
DMKTRD 



DMKTMR 
DMKVIO 



DMKVIO 
DMKTRC 
DMKTRD 



DMKPGS DMKPRV 

DMKTRC DMKTRD 
DMKTRD 

DMKPRV DMKTRC 

DMKPRV DMKTRC 

DMKPRV DMKTMR 



DMKTRD 



DMKTRD 
DMKTRD 



DMKPGS 
DMKTRC 



DMKDIA 
DMKCFS 



DMKTRD 



)MKTRD 



DMKSVC 



DMKTRD 



DMKTRA 



DMKTRC 



DMKTRD 



DMKOSO 



DHKPRG 
DMKTRD 



DMKDSP 
EMKCPI 



DHKPRV 



DHKPSA 
DHKGRF 



DMKSVC 



DMKSCH 
DHKLOG 



DMKTMR 



DMKTMR 
DMKMCC 



DHKTRA 



DHKOSO 
DHKHNI 



DHKTRC 



CHKTRD 



DMKVIO 



DMKQCN DHKRGA DMKSSS 



O 
*xi 

f 
P> 
tJ* 
(0 

V 

f+ 
o 
I 

tat 
O 

a 



n 
n 
o 

(A 
(A 

W 
(D 
H> 
(D 
M 
(D 

O 
to 



— » 

1 

U) 


LABEL 


COONT 


REFERENCES 






















O 


CD 


TBQBLOK 


000080 


DMKBLD 


DMKCDS 


DMKCFC 


DMKCFM 


DMKCFP 


DMKCFS 


DMKCPI 


DMKCPD 


DMKDIA 


DMKDSP 


DMKENT 


DMKGRF 










DMKLOG 


DMKMCC 


DMKHID 


DMKMHI 


DMKMON 


DMKPSA 


DMKQCN 


DMKRGA 


DHKRGB 


DMKSCH 


DMKSSS 


DMKTMR 


<T> 


H 






DMK0SO 
























H 


ffl 

3 


THQBQOE 


000018 


DMKCFP 


DMKSCH 


DMKTMR 




















I 




TRQBSIZE 


000042 


DMKBLD 


DMKCFC 


DMKCFM 


DMKCFS 


DMKCPI 


DMKDIA 


DMKGRF 


DMKLOG 


DMKMCC 


DMKMCD 


DMKMNI 


DMKQCN 


O 








DMKRGA 


DMKSSS 


DMKOSO 




















I 

ac 
o 


THQBTOD 


000036 


DMKCFC 


DMKCFM 


DMKCPI 


DMKEHT 


DMKMCC 


DMKMNI 


DMKMOH 


DMKSCH 


DMKSSS 


DMKTMR 






CO 


TRQBDSER 


000015 


DMKBLD 


DMKCFC 


DMKCFS 


DBKCPI 


DMKDSP 


DMKGRF 


DMKLOG 


DMKMCC 


DMKHNI 


DMKQCH 


DMKRGA 


DMKSSS 


pi 


o 


TRQBVAL 


000039 


DMKCDS 


DMKCFC 


DMKCFM 


EMKCFP 


DMKCPI 


DMKCPD 


DMKDSP 


DMKEHT 


DMKGRF 


DMKMCC 


DMKMID 


DMKMNI 


H 
(0 






DMKMON 


DMKPSA 


DMKQCH 


DMKRGA 


DMKSCH 


DMKSSS 


DMKTMR 












w 


TRON 


000008 


DMKDMP 


DMKMNI 


DMKMOH 




















n 

hi 


*•< 

w 


TTSEGCNT 


000008 


DMKATS 


DMKBLD 


DMKCPU 




















r+ 


TYPBSC 


000044 


DMKACO 


DMKBLD 


DMKCFM 


EMKCFT 


DMKCKP 


DHKCPI 


DMKCPS 


DMKCQG 


DMKCQP 


DMKCQR 


DMKCQY 


DMKDIA 


O 


CD 






DMKHVD 


DMKIOF 


DMKIOS 


DMKLOG 


DMKLOH 


DMKNES 


DMKNLD 


DMKQCN 


DMKRGA 


DMKDSO 


DMKVCN 


DMKVDE 


(ft 


S 






DMKVDS 


DMKWRM 






















(/] 


f 


TYPCTCA 


000027 


DMKCFP 


DMKCPB 


DMKCQG 


DMKDEF 


DMKDIA 


DMKDIE 


DMKDIR 


DMKIOS 


DMKSCN 


DMKVCA 


DMKVDA 


DMKVDC 


S3 


o 






DMKVDR 


DMK7DS 


DMKVMI 


DMKVSI 


















CD 
t-h 
(D 




TYPE 


000147 


DMKAPI 


DMKBLD 


DMKCFC 


EMKCKP 


DMKCPU 


DMKDDR 


DMKDIR 


DMKDSP 


DMKEXT 


DMKFMT 


DMKFRE 


DMKIOS 


O 






DMKMCH 


DHKMCT 


DMKPAG 


DMKPRG 


DMKPRV 


DMKPSA 


DMKPTR 


DMKSCH 


DMKSTK 


DMKSVC 


DMKTMR 


DMKVAT 


M 


p) 






DMKVHA 


DMKVMI 


DMKVSI 


DMKWRM 




















o 


TYPIBM1 


000006 


DMKDEF 


DMKDIA 


DMKDIR 


DHKHLD 


DMKSCN 
















O 


pi 


TYPPRT 


000068 


DMKCFO 


DMKCKP 


DMKCQG 


EBKCQB 


DMKCQR 


DMKCSE 


DMKCSO 


DMKCSP 


DHKCSQ 


DMKCST 


DMKCSO 


DMKCSV 


(D 


•t) 






DMKDEF 


DMKDMP 


DMKDRD 


DMKNLE 


DMKHSP 


DHKSCN 


DMKSPL 


BMKSSP 


DMKVSP 


DMKVSQ 








n 


TYPPDN 


000060 


DMKCKP 


DMKCQR 


DMKCSO 


DMKCSP 


DMKCSQ 


DMKCST 


DHKCSO 


DMKCSV 


DMKDRD 


DMKRSE 


DMKRSP 


DMKSCN 




o 
cr 






DMKSEP 


DMKSPL 


DMKSSP 


DMKVSP 




















TYPRDR 


000019 


DMKCQH 


DMKCSP 


DMKCSQ 


DMKCST 


DMKCSO 


DMKCSV 


DHKDRD 


DMKRSP 


DMKSCN 


DMKSPL 


DMKVMI 


DMKVSI 




(D 


TYPTELE2 


000005 


DMKDEF 


DMKDIA 


DMKDIR 


DMKSCH 




















B 


TYPTIMER 


000005 


DMKCQG 


DMKDIR 


DMKVSP 






















O 


TYPTR 


000001 


DHKLD00E 


























(D 


TYPTTY 


000014 


DMKCFT 


DMKCHS 


DMKCPV 


DMKIOF 


DMKNES 




















TYPONDEF 


000003 


DMKCHS 


DMKNES 


DMKNLD 






















M 


TYPUNSOP 


000003 


DMKCCW 


DMKVMI 
























p. 


TYP1050 


000006 


DMKCHS 


DMKIOF 
























TYP1052 


000009 


DMKDEF 


DMKDIR 


DMKLOG 


DMKSPL 


DMKVDR 


DMKVDS 


DMKVSP 














(U 


TYP1403 


000006 


DMKDEF 


DMKDIR 


DMKDMP 


EMKIOF 


DMKRSE 




















TYP1442R 


000001 


DMKCCW 


























O 


TYP1443 


000006 


DMKDIR 


DMKIOF 


DMKRSE 






















a 


TYP2305 


000074 


DMKATS 


DMKCCW 


DMKCFH 


DMKCKP 


DMKCPI 


DMKCPS 


DMKCPD 


DMKCQG 


DMKCQP 


DHKDAS 


DMKDDR 


DMKDEF 




1 
I 






DMKDGD 


DMKDIR 


DMKDRD 


DMKDSB 


DMKHVD 


DMKIOC 


DMKIOE 


DMKIOF 


DMKIOG 


DMKIOS 


DMKLOG 


DMKPAG 




<t 






DMKPGS 


DMKPGT 


DMKPTR 


DMKSAV 


DMKDHT 


DHKVDA 


DMKVDC 


DMKVED 


DMKVDE 


DMKVDR 


DMKVDS 


DMKVER 




o 

C 






DMKWRM 


























TYP2311 


000019 


DMKCCW 


DMKCQG 


DMKDDR 


BMKDGD 


DMKDIR 


DMKIOC 


DMKLNK 


DMKSCN 


DMKVDS 










B 


TYP2314 


000057 


DMKATS 


DMKCCW 


DMKCFG 


DMKCFH 


DMKCKP 


DMKCKS 


DMKCPI 


BMKCEO 


DMKCQG 


DMKDAS 


DMKDDR 


DMKDGD 




fD 






DMKDIR 


DMKDMP 


DMKDSB 


DMKHVD 


DMKLNK 


DMKHLD 


DHKNLE 


DMKPAG 


DMKPGT 


DMKSAV 


DMKSNC 


DMKSPL 




-» 


TYP2319 


000004 


DMKSSP 
DMKDDR 


DMKTCS 
DMKDRD 


DMKTDK 
DMKHVD 


DMKVDC 


DMKVER 


DMKVSI 



















LABEL 


CODNT 


REFERENCES 


























TYP2401 


000006 


DHKDDR 


DMKTAP 


DMKVMI 
























TYP2415 


000004 


DHKDDR 


DMKTAP 


DMKVMI 
























TYP2420 


000004 


DHKDDR 


DMKTAP 


DMKVMI 
























TYP2501 


000005 


DMKDIR 


DMKIOF 


DMKRSE 


DMKVHI 






















TYP2520P 


000002 


DHKRSE 




























TYP252 0R 


000001 


DMKIOF 




























TYP2540P 


000005 


DMKACO 


DMKDIR 


DMKMIA 


DHKRSE 


DMKSSP 




















TYP2540R 


000008 


DMKDIR 


DMKIOF 


DHKRSE 


DHKRSP 


DHKSSP 


DHKVHI 


















TYP2700 


000003 


DMKIOF 


DMKNES 


DHKSCN 
























TYP2741 


000013 


DMKCFC 


DHKCNS 


DMKCPI 


DMKIOF 






















TYP2 955 


000001 


DHKCCW 




























TYP3066 


000013 


DMKCPI 


DMKCPV 


DMKGRF 


DMKIOF 


DHKOPR 


DHKSSP 


















TYP3138 


000002 


DMKDIR 




























TYP3148 


000002 


DMKDIR 




























TYP3158 


000002 


DMKDIR 




























TYP3203 


000016 


DMKCSB 


DMKDEF 


DHKDIR 


DMKIOF 


DHKRSE 


DHKVSP 


















TYP3210 


000045 


DMKCCW 


DMKCFP 


DHKCKP 


DMKCNS 


DHKCPB 


DMKCPI 


DHKCQG 


DHKCSP 


DHKCSQ 


DHKCST 


DHKDIA 


DHKDIR 










DMKHVD 


DMKIOF 


DHKSCN 


DMKSPL 


DHKSSP 


DMKVCN 


DMKVDS 


DHKVSI 


DHKVSP 


DHKVSQ 










TYP3211 


000024 


DMKCSB 


DMKDEF 


DHKDIR 


DMKIOF 


DHKRSE 


DMKSPL 


DMKVDR 


DHKVSP 














TYP3215 


000004 


DMKCFP 


DMKDIR 


























TYP3277 


000036 


DMKACO 
DMKVDS 


DMKCCW 


DMKCFT 


DMKCKP 


DMKCPI 


DHKCPV 


DMKDIA 


DMKDIB 


DHKDIR 


DMKGRF 


DHKHVD 


DHKSSP 


O 




TYP3278 


000026 


DMKCCH 


DMKCFT 


DHKCKP 


DMKCPI 


DMKCPV 


DHKGRF 


DHKHVD 


DHKVDS 










*d 




TYP3284 


000014 


DMKCKP 


DMKCPV 


DMKGRF 




















f 




TYP3330 


000080 


DMKATS 


DMKCCW 


DMKCFG 


EHKCFH 


DHKCFP 


DHKCKP 


DMKCKS 


DHKCPI 


DMKCPU 


DHKCQG 


DHKCQP 


DHKDAS 










DMKDDR 


DMKDGD 


DMKDIR 


DHKDHP 


DHKDRD 


DMKDSE 


DHKFMT 


DMKHVD 


DHKIOC 


DHKIOE 


DHKIOF 


DMKIOG 








DMKIOS 


DHKLNK 


DMKLOG 


DHKNLD 


DHKNLE 


DMKPAG 


DMKPGT 


DMKSAV 


DHKSNC 


DHKSSS 


DMKTCS 


DHKTDK 


e 








DHKONT 


DMKVDA 


DHKVDC 


DMKVER 


DHKVSI 


DHKWRH 














l 

rt- 
O 




TYP3340 


000070 


DMKCCW 


DMKCFH 


DHKCKP 


EHKCPI 


DHKCQG 


DHKDAS 


DMKDDR 


DMKEGE 


DHKDIR 


DHKDHP 


DHKDRD 


DHKDSB 


o 






DMKGIO 


DMKHVD 


DHKIOE 


DHKIOF 


DHKIOG 


DHKESW 


DHKPAG 


DMKPGT 


DMKSAV 


DHKSPL 


DHKSSP 


DHKTDK 


I 


^ 






DMKUNT 


DMKVDC 


DHKVDE 


DHKVER 


DHKVIO 


DHKVSI 


DHKWRH 












at 
o 
Pi 


o 


TYP3350 


000076 


DMKATS 


DMKCCW 


DHKCFG 


DHKCFH 


DHKCKP 


DMKCKS 


DMKCPI 


DHKCPU 


DHKCQG 


DHKDAS 


DHKDDR 


DHKDGD 


H- 






DMKDIR 


DMKDMP 


DHKDRD 


IIHKFHT 


DMKHVD 


DMKIOE 


DMKIOF 


DHKIOG 


DMKMSW 


DHKNLD 


DHKNLE 


DHKPAG 


a 








DMKPGT 


DMKSAV 


DHKSNC 


DHKSPL 


DMKSSP 


DMKTCS 


DHKTDK 


DHKUNT 


DHKVDC 


DHKVER 


DHKVSI 


DMKWRM 




O 


TYP3410 


000008 


DMKCCW 


DMKDDR 


DHKIOE 


DHKIOF 


DMKTAP 


















o 


TYP3411 


000002 


DMKDDR 
























n 
o 


TYP3420 


000009 


DMKCCW 


DHKDDR 


DHKDHP 


DHKIOE 


DMKIOF 


DHKTAP 














H- 


TYP3505 


000008 


DMKDIR 


DMKIOF 


DHKRSE 


DHKVSP 


















M 




TYP3525 


000002 


DMKDIR 
























w 


TYP3704 


000002 


DMKCCW 


DMKVIO 






















w 




TYP3705 


000019 


DMKBLD 
DMKVCH 


DHKCCW 
DMKVDC 


DHKCKP 
DMKVDS 


DHKCPS 
DHKVSI 


DMKCQP 
DHKWRH 


DHKNES 


DMKNET 


DHKNLD 


DHKNLE 


DHKRNH 


DHKSCN 


DMKUSO 


(T> 
(D 


1 


TYP3800 


000036 


DMKCCW 
DMKSSP 


DHKCKP 
DHKVDR 


DMKCKS 
DMKVDS 


DHKCPI 
DHKWRH 


DHKCPS 


DMKCQP 


DMKCSO 


DHKIOF 


DHKIOS 


DHKRSE 


DHKRSP 


DHKSEP 


11 

P 

o 


(a) 
00 


TYP3851 


000005 


DMKCCW 


DMKCFP 


DHKCKP 


DMKCPI 


DHKSCN 
















U) 


OC 


000097 


DMKBSC 


DMKCKP 


DMKCNS 


EHKCPI 


DHKDAS 


DHKDDR 


DMKDIB 


DHKDIR 


DHKDHP 


DHKDSB 


DHKDSP 


DHKFHT 


(D 



I 

00 

4CS 



H 
W 

36 

<J 
£36 
\ 
UJ 
'J 

o 

to 

w 
(+ 

a 

£»4 

o 

n 

oj 

a 

Pi 

*« 
M 
O 



«D 
t+ 

(D 

n 

H- 

D 
0) 

f+ 
p. 

o 

I 
I 

o 

c 

a 

(D 



LABEL 



OCASE 

OCMTRL 

OCNTRLSZ 

UCURPASS 

ODASDDEV 

UDASDDIR 

UDASDBAC 

ODBFBLOK 

UDBFDASD 

UDBFSIZE 

DDBFVADD 

ODBFWORK 

UDEVAD 

UDEVADD 

ODEVBLOK 

DDEVCLAS 

UDEVCODE 

UDEVDASD 

UDEVDED 

UDEVDISP 

UDEVF 

UDEVFTR 

UDEVLINK 

UDEVLKDV 

UDEVLKID 

DDEVLM 

UDEVLONG 

ODEVLR 

UDEVLW 

UDEVMODE 

UDEVMR 

UDEVMW 

UDEVNCYL 

UDEVPASM 

ODEVPASR 

UDEVPASW 

UDEVR 

ODEVRELN 

ODEVRR 

ODEVSIZE 

ODEVSPOO 

ODEVSTAT 

UDEVTDSK 



COUNT 



000032 

000004 
000003 
000002 
000004 
000002 
000002 
000017 
000004 
000016 
000013 
000006 
000002 
000048 
000051 
000006 
000001 
000005 
000003 
000011 
000001 
000010 
000010 
000004 
000010 
000045 
000006 
000015 
000027 
000017 
000002 
000002 
000007 
000003 
000006 
000003 
000002 
000004 
000002 
000018 
000001 
000026 
000006 



REFERENCES 



DMKGRF 
DMKSSP 
DHKCFH. 
DMKRNH 
DMKDDO 
DMKDDO 
DMKODO 
DMKDDO 
DMKODO 
DMKUDU 
DMKCFS 
DMKUDR 
DMKCFS 
DMKCFS 
DMKUDR 
DMKODO 
DMKDEF 
DMKDEF 
DMKDEF 
DMKUDU 
DMKDIR 
DMKDIR 
DMKDEF 
DMKUDU 
DMKDEF 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDEF 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDEF 
DMKDEF 



DMKHVC 
DMKTAP 
DMKCFM 



DMKDEF 



DMKDEF 
DMKDEF 



DMKDIR 
DMKDIR 
DMKDIR 

DMKUDR 
DMKLNK 
DMKDIR 

DMKDIR 
DMKLNK 
DMKLNK 
DMKLNK 
DMKLNK 
DMKLNK 
DMKLNK 
DMKLNK 
DMKLNK 
DMKUDU 
DMKUDU 
DMKDIR 

DMKLNK 

DMKLNK 
DMKLNK 
DMKUDU 
DMKLOG 

DMKDIR 
DMKDIR 



DMKIOE 
DMKTRK 
DMKCFO 



DMKHVD 



DMKHVD 
DMKHVD 



DMKLNK 
DMKLNK 
DMKVDS 

DMKUDU 
DMKLOG 
DMKLNK 

DMKLNK 
DMKLOG 
DMKLOG 
DMKLOG 
DMKUDU 
DMKLOG 
DMKUDU 
DMKUDU 
DMKLOG 



DMKLNK 
DMKUDU 

DMKSCN 

DMKUDR 

DMKLNK 
DMKLNK 



DMKIOS DMKLDOOE DMKHON DMKNLD DMKNLE DMKOPR 
DMKUNT DMKVCA DHKVCH DMKVDC DMKVDE DMKVIO 
EMKCNS DMKCPI DMKGRF DMKLNK DMKMSW DMKNLD 



DMKLNK 
DMKLNK 



DMKLOG 
DMKLOG 



DMKRNH 
DMKVMI 
DMKNLE 



DHKRSE DMKRSP 
DMKVSI DMKVSP 
DHKQCN DMKRGA 



DMKLNK DMKLOG 



DMKLOG 
DMKLOG 



DMKSSS 
DMKSCN 



DMKSPL 



DMKLOH 
DMKSPL 



DMKUDR 
DMKSSS 



DMKUDR 

DMKSPL 
DMKUDR 



DMKUDU 
DMKUDR 



DMKVD1 
DMKUDU 



DMKVDS 
DMKVDA 



DMKVDS 



DMKLOG DMKUDR DMKUDU 



DMKLOG DMKSCN DMKVDS 
DMKSSS 



DMKUDU 



DMKUDU DMKVDA DMKVDS 



DMKVDS 



DMKVDS 



DMKLOG DMKUDU DMKVDS 
DMKLOG DMKVDS 



o 

*a 

t* 
ot 
er 

<D 
M 

i 

o 

at 
o 

Di 
C 
M 
fl> 

O 
M 
O 

W 
W 

SO 
(B 
Mi 
(D 
1-1 
<D 
D 
O 





LABEL 


COUNT 


REFERENCES 




















UDEVTYPC 


000026 


DMKDEF 


DMKDIR 


DMKLHK 


DMKLOG 


DMKVDS 














ODEVTTPE 


000020 


DMKDEF 


DMKDIR 


DHKLNK 


DMKLOG 


DMKVDS 














ODEVVRR 


000004 


DMKDIR 


DMKODU 


DMKVDS 


















0DEY7SEB 


000027 


DMKDIR 


DHKLNK 


DMKLOG 


DHKSSS 
















UDEVW 


OOOOOU 


DMKDIR 


DHKLNK 


DMKVDA 


















UDEVWR 


000002 


DMKDIR 


DMKUDU 




















UDEV3158 


000003 


DMKDEF 


DMKDIR 


DMKYDS 


















ODIBAD 


000002 


DMKUDU 






















UDIRBLOK 


000021 


DMKCFS 


DMKCPI 


DMKCSP 


DMKDEF 


DMKDIR 


DMKHVD 


DHKLNK 


DMKLOG 


DMKSPL DMKUDR DMKUDU 






ODIRDASD 


000004 


DMKDIR 


DMKUDR 


DMKUDU 


















ODIRDISP 


000010 


DMKCFS 


DMKDEF 


DMKDIR 


DMKHVD 


DHKLNK 


DMKLOG 


DMKSPL 


DMKUDR 


DMKUDU 






ODIRF 


000004 


DHKODD 






















ODIRPASS 


000010 


DMKCPI 


DMKCSP 


DMKDIR 


DMKLOG 


DMKUDU 














DDIRSIZE 


000011 


DMKCSP 


DMKDIR 


DMKUDR 


DMKUDU 
















DDIRDSER 


000013 


DMKDIR 


DMKHVD 


DMKLOG 


DMKUDR 
















UDISPDEV 


000003 


DMKODU 






















UDISPMAC 


000002 


DMKDDO 






















OE 


000056 


DMKCHS 


DMKCSB 


DMKDDR 


DMKDIR 


DHKDHP 


DMKFMT 


DMKGIO 


DMKGRF 


DMKHVC DMKIOG DMKIOS DMKMOH 










DMKRGA 


DMKRHH 


DHKRSP 


EHKSEP 


DMKSSP 


DMKVC1 


DMKVCN 


DMKVMI 


DMKVSI DHKVSP 






FLAGS 


000026 


DMKODU 






















OIPARMS 


000002 


DMKODO 






















UIPARMSZ 


000004 


DMKODO 


















o 




ULOCDVAD 


000001 


DMKUDU 




















UMACACC 


000002 


DMKDIR 


DMKLOG 
















r« 




UMACACCT 


000013 


DMKDIR 


DMKHVD 


DMKLOG 


DMKUDU 
















UMACAD 


000009 


DMKODO 


















fl> 




UMACAFF 


000008 


DMKCFS 


DMKDIR 


DMKLOG 


DMKUDU 












v 




UMACBLOK 


000031 


DMKCFS 


DMKDEF 


DMKDIR 


DMKHVD 


DMKLOG 


DMKSPL 


DMKUDR 


DMKUDU 




i 




UMACBMX 


000002 


DMKDIR 


DMKLOG 
















O 


n 


UMACCDEL 


000002 


DMKDIR 


DMKLOG 
















1 

a 
o 


►a 


UMACCLA 


000001 


DMKLOG 


















o 


DHACCLEV 


000006 


DMKDIR 


DMKLOG 


DMKUDU 














P< 


H- 


UHACCORE 


000003 


DMKDIR 


DMKLOG 


DMKUDU 
















fl> 


UMACCPU 


000002 


DMKDIR 


DMKLOG 
















(D 


o 


UMACDASD 


000002 


DMKDIR 


DMKUDR 


















O 


UMACDISP 


000003 


DMKDIR 


DMKUDR 
















hi 


UHACDIST 


000010 


DMKDIR 


DMKLOG 


DMKSPL 


DMKUDU 












O 


H- 


UMACDVCT 


000004 


DMKDIR 


DMKLOG 


DMKUDR 


















UMACECOP 


000002 


DMKDIR 


DMKLOG 
















UHACES 


000002 


DMKDIR 


DMKLOG 
















W 




UHACF 


000001 


DMKUDO 


















fl> 
(D 




UMACFFON 


000003 


DMKDIR 


DMKLOG 


DMKUDU 














_i 


UMACIPL 


000005 


DMKDIR 


DMKLOG 


DMKUDU 
















1 

U) 
00 


UHACISAM 


000002 


DMKDIR 


DMKLOG 
















UMACLDEL 


000002 


DMKDIR 


DMKLOG 
















o 


Ol 


UMACLEHD 


000005 


DMKDIR 


DMKLOG 


DMKUDU 














(0 



I 

Ui 
GO 
ON 



H 
M 

at 

<i 
ts 
\ 

U) 

-J 
o 

w 

w 

r+ 
(D 

a 

t-< 
o 

n 

» 

•t) 
M 
O 

tr 



a> 

(0 

n 

a 

H- 
O 
P> 
r+ 
H- 
O 
CJ 

I 
I 

< 
o 

M 
(3 

B 
(D 



LIBEL 



OHACMCOR 

OHACNSVC 

OMACOPT 

0MACOPT2 

OMACPRIR 

OMACPOID 

OMACRT 

OMACSIZE 

ONACVROP 

OMDISKAD 

OMDISKMD 

OMDISKMP 

OMDISKRP 

OMDISKWP 

ONEWPASS 

ONFIN 

DNOOPF 

ONSHRVM 

OOBJVMBK 

OOP 

OOPTIONS 

OPRIOR 

OPRIV 

ORECMP 

DRETCODE 

DRPAGDEV 

ORPAGDIR 

DRPAGMAC 

OSERCARD 

USERCL 

OSTORAGE 

OSVDASD 

OTESTMD 

ODSERID 

OVMBLOK 

OVPAGBOF 

OVPAGDIR 

OWORK 

VCHADD 



COUNT 



000004 
000002 
000015 
000002 
000004 
000003 
000002 
000005 
000002 
000001 
000001 
000001 
000002 
000001 
000001 
000005 
000002 
000001 
000002 
000005 
000001 
000002 
000003 
000003 
000013 
000003 
000003 
000002 
000002 
000004 
000002 
000003 
000016 
000003 
000002 
000007 
000003 
000023 
000045 



REFERENCES 



VCHBLOK 000063 



VCHBMX 000011 
VCHBOSY 000010 
YCHCEDEV 000004 



DMKDEF 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DMKDIR 
DHKDIR 
DMKDIR 
DMKODO 
DMKODO 
DMKODO 
DMKUDO 
DMKODU 
DMKODO 
DMKMIA 
DMKODO 
DMKCPO 
DMKODO 
DMKODO 
DMKODO 
DMKODO 
DMKODO 
DMKODO 
DMKODO 
DMKODO 
DMKODO 
DMKODO 
DMKACO 
DMKMCC 
DMKODO 
DMKODO 
DMKODO 
DMKODO 
DMKODO 
DMKODO 
DMKODO 
DMKODO 
DMKCFM 
DMKSPL 
DMKCFM 
DMKLNK 
DMKVDS 
DMKDEF 
DMKCFP 
DMKCFP 



DMKDIR 
DMKLOG 
DMKLOG 
DMKLOG 
DMKLOG 
DMKLOG 
DMKLOG 
DMKODR 
DMKLOG 



DMKCKP 
DMKMNI 



DMKCFP 
DMKSSS 
DMKCFP 
DMKLOG 
DMKVIO 
DMKPRV 
DMKDSP 
DMKDSP 



DMKODO 



DMKODO 



DMKODO 
DMKODO 



DMKMON 



DMKCPB 
DMKVCH 
DMKCKP 
DMKPRV 
DMKVSI 
DMKVCH 
DMKVIO 
DMKVIO 



EHKCQG DMKCSP DMKCSD DMKCSV DMKDEF DMKDIA 



DMKVCH 
EMKCPB 
DMKSCN 
DMKVSP 
DMKVDS 
DMKVSI 
DMKVSP 



DMKVDA 
DMKCPV 
DMKSPL 

DMKVIO 



DMKVDE 
DHKCQG 
DMKSSS 

DMKVSI 



DMKVDS 
DMKCSP 
DMKOSO 

DMKVSP 



DMKVIO 
DMKCSO 
DMKVCH 



DMKVSI 
DMKCSV 
DMKVCN 



DMKDSP 
DMKVSP 
DMKDEF 
DMKVDA 



DMKLOG 



DMKDIA 
DMKVDC 



DMKSCN 



DMKDSP 
DMKVDD 



o 

tr 
<t> 

H 

i 

r+ 
o 

I 

at 
o 

e 

M 

rt> 

o 
i-i 
o 
to 
to 

to 
a> 

M» 
(D 

p 
o 





LIBEL 


COUNT 


REFERENCES 
























VCHCEPND 


000010 


DMKCFP 


DMKDSP 


DMKVIO 


DHKVSI 


DHKVSP 


















VCHCOINT 


000013 


DMKCFM 


DMKCFP 


DMKCPB 


DHKDSP 


DHKSSS 


DHKVCN 


DHKVIO 


DHKVSI 


DHKVSP 










VCHCUTBL 


000037 


DHKCFH 


DMKCFP 


DNKCKP 


DHKCPV 


DHKCQG 


DHKCSE 


DHKCSO 


DHKCSV 


DHKDEF 


DHKDIA 


DHKDSP 


DHKPRV 








DMKSCN 


DMKSPL 


DMK7CH 


DHKVDC 


DHKVDD 


DHKVDS 


DHKVIO 


DHKVSI 


DHKVSP 










VCHDED 


000010 


DMKCFP 


DMKDEF 


DMKLNK 


DHKVCH 


DHKVDA 


DHKVDC 


DHKVDD 


DHKVSI 












VCHSEL 


000017 


DMKDEF 


DMKDSP 


DMKPR7 


CMKVCH 


DHKVDS 


DHKVIC 


DHKVSI 


DHKVSP 












VCHSIZE 


000011 


DNKLOG 


DMKOSO 


DHK7CH 


DHKVDC 


DHKVDS 


















VCHSTAT 


000030 


DMKCFP 


DMKDEF 


DHKDSP 


DHKLNK 


DHKVCH 


DHKVDA 


DHKVDC 


DHKVDD 


DHKVIO 


DHKVSI 


DHKVSP 






VCHTYPE 


000024 


DMKDEF 


DMKDSP 


DHKPR7 


DNKVCH 


DHKVDS 


DHKVIO 


DHKVSI 


DHKVSP 












VCONADDR 


000005 


DMK7CN 


























VCONBFSZ 


000004 


DMK7CN 


DMK7DR 
























VCONBOF 


000010 


DMK7CN 


DMK7DR 
























VCONCAW 


000006 


DMK7CN 


























VCONCCH 


000014 


DMK7CN 


























VCONCNT 


000006 


DMK7CN 


























VCONCOWD 


000020 


DMK7CN 


























VCONCTL 


000006 


DMKALG 


DMKCFP 


DNKGRF 


DHKRGA 


DHKVCN 


DHKVDR 
















VCONDWC 


000007 


DMK7CN 


























VCONFLRG 


000026 


DMKVCN 


























VCONIDAP 


000003 


DMK7CN 


























VCONRBSZ 


000006 


DMKALG 


DMKCFP 


DHKGRF 


DHKRGA 


DHKVCN 


DHKVDR 
















7C0NRBUF 


000014 


DMKALG 


DMKCFP 


DNKGRF 


DHKRGA 


DHKVCN 


DHKVDR 
















VCONRCNT 


000005 


DMKALG 


DMKGRF 


DHKRGA 


EHKVCN 




















VCONSIZE 


000003 


DHK7DR 


DHKVDS 
























VCONHBSZ 


000005 


DMKCFP 


DHKVCN 


DHKVDR 






















VCONWBOF 


000009 


DMKCFP 


DMK7CN 


DNK7DR 






















VCONWCNT 


000002 


DMK7CN 


























VCOACTV 


000012 


DMKCFP 


DMK7I0 


DMKVSI 






















VCOADD 


000032 


DMKCFM 


DMKCFP 


DHKCPB 


DHKCQG 


DMKCSP 


DHKCSU 


DHKCSV 


DHKDEF 


DHKDIA 


DHKDSP 


DHKLOG 


DHKSCN 


o 






DMKSPL 


DMKSSS 


DNKVCH 


DHKVCN 


DHKVDD 


DHKVDS 


DHKVIO 


DHKVSI 


DHKVSP 








*n 


7CUBL0K 


000048 


DMKCFM 


DMKCFP 


DNKCKP 


DHKCPB 


DHKCPV 


DHKCQG 


DHKCSP 


DHKCSO 


DHKCSV 


DHKDEF 


DHKDIA 


DHKDSP 


o 






DMKLOG 


DMKNLD 


DNKPR7 


DHKSCN 


DHKSPL 


DHKSSS 


DHKOSO 


DHKVCH 


DHKVCN 


DHKVDA 


DHKVDC 


DHKVDD 


H- 






DMK7DS 


DNK7IO 


DHK7SI 


DHKVSP 




















VCOBOSY 


000009 


DMKCFP 


DNK7I0 


DNK7SI 




















O 


VCOCEPND 


000004 


DMKCFP 


DNKDSP 


DNK7CN 


DHKVIO 


















O 

hi 


7CUCHBSY 


000004 


DMKCFP 


DMK7I0 






















7CDCTCA 


000011 


DMKDEF 


DMKDSP 


DHKVDS 


DHKVIO 


DHKVSI 
















H« 


7C0CUEPN 


000004 


DMKCFP 


DNK7I0 


DNKVSI 




















(A 


7C0D7IHT 


000013 


DMKCFM 


DMKCFP 


DHKCPB 


DHKDSP 


DHKSSS 


DHKVCN 


DHKVIO 


DHKVSI 


DHKVSP 








7CDD7TBL 


000046 


DMKCFM 


DNKCFP 


DNKCKP 


DHKCPV 


DHKCQG 


DHKCSP 


DHKCSO 


DHKCSV 


DHKDBF 


DHKDIA 


DHKDSP 


DHKNLD 








DMKPR7 


DMKSCN 


DHKSPL 


DHKOSO 


DHKVCH 


DHKVDA 


DHKVDC 


DHKVDD 


DHKVDS 


DHKVIO 


DHKVSI 


DHKVSP 




VCOINTS 


000012 


DMKCFP 


DNKDSP 


DHK7I0 


DHKVSI 


















— * 
1 


7C0SHHD 
7C0SIZE 


000006 
000013 


DMKDSP 
DNKLOG 


DNK7CN 
DNKOSO 


DHKVDS 
DNKVCH 


DHKVIO 
DHKVDC 


DHKVSI 
DHKVDS 
















00 


VCOSTAT 


000029 


DMKCFP 


DNKDSP 


DHKVCN 


DHKVIO 


DHKVSI 
















*J 


7CUTYPE 


000014 


DMKDEF 


DMKDSP 


DHKVCN 


DHKVDS 


DHKVIO 


DHKVSI 















o 
tr 

V 

o 

i 

EX 
O 
Q< 

a 



o 
H 
o 

(0 

in 

w 

<D 
Hi 
<D 
H 
(D 
P 
O 



1 

CO 


LIBEL 


COUNT 


REFERENCES 






















n 


CD 
CD 


?DE¥ADD 


000052 


DMKCFM 


DMKCFP 


DHKCPB 


DHKCQG 


DHKCQP 


DHKCSE 


DHKCSQ 


DHKCST 


DHKCSD 


DHKCSV 


DHKDEF 


DHKDIA 


If 
0) 

ti* 








DMKDSP 


DMKLOG 


DHKNLD 


DHKSCN 


DHKSPL 


DHKSSS 


DHKDSO 


DHKVCH 


DHKVCN 


DHKVDC 


DHKVDD 


DHKVDS 


(D 


H 

to 






DMKVIO 


DMKYSI 


DHKVSP 




















I 


VDEVATTN 


000008 


DMKYCN 
























f+ 




VDEVAUCR 


000002 


DHKALG 


DMKCFP 






















O 
i 


"3 

3 


VDEVBLOK 


000128 


DMKACO 


DMKALG 


DHKCCH 


DHKCCW 


DHKCFG 


DHKCFH 


DHKCFH 


DHKCFP 


DHKCKP 


DHKCPB 


DHKCPS 


DHKCPV 


I 

SK 


\ 






DHKCQG 


DMKCQP 


DHKCSB 


DHKCSP 


DHKCSQ 


DHKCST 


DHKCSU 


DHKCSV 


DHKDAS 


DHKDEF 


DHKDGD 


DHKDIA 


O 


UJ 






DHKDIB 


DMKDRD 


DHKDSP 


DHKGIO 


DHKGRF 


DHKHVC 


DHKHVD 


DHKIOS 


DHKLNK 


DHKLOG 


DHKNLD 


DHKPRV 


a 


o 






DMKQCN 


DHKRGA 


DHKSCN 


DHKSPL 


DHKSSS 


DHKTHI 


DHKTRC 


DMKTRI 


DHKTRK 


DHKUNT 


DHKOSO 


DHKVCA 








DMKYCH 


DMKYCN 


DHKVDA 


DHKVDC 


DHKVDD 


DHKVDR 


DHKVDS 


DHKVIB 


DHKVIO 


DHKVSI 


DHKVSP 


DHKVSQ 


(0 




VDEVBND 


000019 


DMKACO 


DMKCCW 


DHKCKP 


DHKCQG 


DHKCQP 


DHKDGD 


DHKLNK 


DHKSSS 


DHKVDR 


DHKVDS 


DHKVSI 




o 


m 


VDEVBOST 


000038 


DMKCFM 


DMKCFP 


DHKCPB 


DHKDGD 


DHKDRD 


DHKGIC 


DHKSSS 


DHKVCN 


DHKVIO 


DHKVSI 


DHKVSP 




M 


c+ 


VDEVCATT 


000004 


DMKVDA 


DMKVDD 


DHKVDR 




















O 


m 


VDEVCCW1 


000028 


DMKCFP 


DMKVCA 


DHKVCN 


DHKVSP 


















(A 


VDEVCFCL 


000006 


DMKYSP 


DHKVSQ 
























f* 


VDEVCFLG 


000020 


DMKALG 


DHKCFP 


DHKVCN 




















Hi 


o 


VDEVCHAN 


000017 


DMKCFP 


DHKDGD 


DHKDSP 


DHKGIO 


DHKVCN 


DMKVIC 


DHKVSI 


DHKVSP 










J_i. 


VDEVCHBS 


000016 


DMKCFM 


DHKCFP 


DHKVCN 


DMKVIO 


DHKVSI 


DHKVSP 














(t> 


o 


VDEVCLAS 


000022 


DMKCKP 


DHKCQG 


DHKCSP 


DMKCSD 


DHKCSV 


DHKDRD 


DHKSPL 


DHKVDS 


DHKVSP 


DHKVSQ 






(D 

a 


p) 


VDEVCON 


000007 


DMKALG 


DHKCFP 


DHKGRF 


DHKRGA 


DHKVCN 


DHKYDR 


DHKVDS 












a 


VDEVCONT 


000012 


DMKCQG 


DHKCSP 


DHKCSQ 


DHKDRD 


DHKVSP 
















o 


Oi 


VDEVCOPY 


000006 


DMKCKP 


DHKCQG 


DHKCSP 


DHKSPL 


DHKVDS 
















(t) 


•ti 


VDEVCPEX 


000008 


DMKCCW 


DHKCFP 


DHKDGD 


DHKGIO 




















M 


YDEYCSPL 


000015 


DMKCFP 


DHKCPS 


DHKCQG 


DHKCSP 


DHKDAS 


DHKQCH 


DHKSPL 


DHKVCN 


DHKVDS 


DHKVSP 








o 

ti* 


YDEYCSW 


000113 


DMKCFP 


DHKCSP 


DHKCS0 


DHKCSV 


DHKDSP 


DHKGIC 


DHKSPL 


DHKTRC 


DHKTRK 


DHKONT 


DHKVCN 


DHKVIO 




m 






DMKYSI 


DHKVSP 
























fl> 


YDEYCOE 


000011 


DMKCFP 


DHKDSP 


DHKVIO 


DHKVSI 




















a 


YDEYDED 


000062 


DMKCCW 


DHKCFP 


DHKCKP 


DHKCPB 


DHKCPV 


DHKCQG 


DHKCSB 


DHKCSP 


DHKCSQ 


DHKCST 


DHKDEF 


DHKDGD 




o 






DMKDIA 


DHKGIO 


DHKHVD 


DHKPRV 


DHKSCN 


DHKTRD 


DHKVDD 


DHKVDR 


DMKVDS 


DHKVER 


DHKVIO 


DHKVSI 










DMKYSP 


























YDEYDET 


000003 


DMKSCN 


DHKYDR 
























M 


VDEVDIAG 


000008 


DHKDRD 


DHKVSP 
























H 


YDEVDIAL 


000017 


DMKCCff 


DHKCFP 


DHKDIA 


DHKDIB 


DHKNLD 


DHKVSI 
















» 


VDEYDLY 


000003 


DMKSPL 


DHKVSP 
























P> 


YDEYENAB 


000012 


DMKCCW 


DHKCFP 


DHKCQG 


DHKDIA 


DHKDIB 


DHKVSI 
















p. 


YDEVEOF 


000009 


DHKCQG 


DHKCSP 


DHKVDS 


DHKVSP 




















o 


7DEYEXTN 


000013 


DMKCKP 


DHKCQG 


DHKCSP 


DHKCSI 


DHKSPL 


DHKVDR 


DHKVDS 














a 
l 


YDEYFCBK 
YDEVFEED 


000013 
000007 


DMKCSB 
DMKCFP 


DHKYDR 
DHKVSP 


DHKVSP 






















<i 


YDEYFLAG 


000131 


DMKACO 


DHKCCW 


DHKCFP 


DHKCKP 


DHKCPS 


DHKCPV 


DMKCQG 


DHKCQP 


DHKCSP 


DHKDAS 


DHKDEF 


DHKDGD 




o 






DMKDIA 


DHKDIB 


DHKDSP 


DHKGIO 


DHKLNK 


DHKNLD 


DHKQCN 


DHKSCN 


DHKSPL 


DHKONT 


DHKVCH 


DHKVCN 




c 






DMKVDC 


DHKVDR 


DHKVDS 


DMKVIO 


DHKVSI 


DHKVSP 


















YDEYFLG2 


000041 


DMKCCW 


DHKCFP 


DHKDEF 


DHKDGD 


DHKGIO 


DHKLOG 


DHKONT 


DHKVDA 


DHKVDR 


DHKVDS 


DHKVSI 






YDEYFOR 


000020 


DMKCQG 


DHKCSP 


DHKSPL 






















— » 


YDEVHOLD 


000009 


DHKCQG 


DHKCSP 


DHKSPL 


DHKVSP 






















YDEYINTS 


000034 


DMKCFM 


DHKCFP 


DHKCPB 


DHKDSP 


DHKSSS 


DHKVCA 


DHKVCN 


DHKVIO 


DHKVSI 


DHKVSP 











LABEL 


CODHT 


REFERENCES 


























?DEVIOB 


000017 


DHKCFP 


DHKDGD 


DHKDIA 


DHKDIB 


DHKGIO 


DHKH7C 


DHK7I0 


DHKVSI 














7DEVI0CT 


000008 


DHKIOS 


DHK7CA 


DHK7CH 


DHK7SP 






















VDEVIOER 


000027 


DHKCCH 


DHKCCH 


DHKCFP 


DHKDGD 


DHKDSP 


DHKGIC 


DHK7I0 


DHKVSI 














VDEVKEY 


000013 


DMK7CH 


DHK7SP 


























VDEVLIHK 


000025 


DHKCFP 


DHKDEF 


DHKSCH 


DHKOHT 


DHK7CH 


DHK7DC 


DHKYDR 


DHKVDS 














VDEVHRDY 


000027 


DMKCFP 


DHKCPB 


DHKCQG 


DHKDIA 


DHKYCA 


DHK7CS 


DHKVDS 


DHKVIO 


DHKVSI 


DHKVSP 










VDEVODE 


000007 


DHKCFP 


DHKOHT 


DMK7SI 
























VDEVPEND 


000020 


DHKCFH 
DHK7IO 


DHKCFP 
DHK7SI 


DHKCPB 
DHK7SP 


DHKCSP 


DMKCSD 


DHKCS7 


DHKDGD 


DHKESP 


DHKGIO 


DHKSPL 


DHKSSS 


DHKVCH 






VDEVPOSH 


000016 


DHKCCH 


DMKDEF 


DHKDGD 


DHKGIO 


DHK7I0 




















VDEVPOST 


000005 


DHKDSP 


DHK7I0 


DHK7SI 
























VDEVPORG 


000010 


DHKCSP 


DHKCSQ 


DHK7SP 


DHK7SQ 






















VDEVRDO 


000014 


DHKCCH 


DHKCQG 


DHKCQP 


DHKDGD 


DHKLHK 


DHKSCH 


DHKYDS 


DHKVSI 














VDEVREAL 


000069 


DHKACO 


DHKCCH 


DMKCFG 


DHKCFH 


DHKCFP 


DHKCKE 


DHKCPB 


DHKCQG 


DHKCQP 


DHKDGD 


DHKDIA 


DHKHVD 










DHKIOS 


DHKLHK 


DHKLOG 


DHKPR7 


DHKSCH 


DHKTHI 


DHKTRD 


DHKTRK 


DHKOHT 


DHKVCA 


DHKVDD 


DHKYDR 










DHK7D5 


DHK7ER 


DHK7SI 
























VDE7RELH 


000034 


DHKCCH 
DHK7DS 


DHKCFG 
DHK7ER 


DHKCFH 
DHK7I0 


DHKCQP 


DHKDEF 


DHKDGD 


DHKGIO 


DHKLHK 


DHKSCN 


DHKSSS 


DHKOHT 


DHKVDR 






7DE7RES 


000009 


DHKCCH 


DMKCFP 


DHKDGD 


DHKGIO 


DHKOHT 


DHK7SI 


















7DE7RRB 


000011 


DHKCCH 


DMKCFP 


DHKDGD 


DHKGIO 


DHKOHT 


DHK7DR 


DHKYDS 


DHKVSI 














7DE7RRF 


000011 


DMKCCH 


DMKCFP 


DHKDGD 


DHKGIO 


DHKYDR 


DHK7DS 


DHKVSI 
















7DE7RSRL 


000003 


DHKCCH 


DHKCFP 


DHK7DS 




















CI 




7DE7SAS 


000004 


DHKCCH 


DHK7I0 


























7DE7SFLG 


000070 


DHKCFP 


DHKCKP 


DHKCQG 


DHKCSP 


DHKCSQ 


DHKDRD 


DMKQCH 


DHKSPL 


DHKVCH 


DHKVDD 


DHKVDS 


DHKVSP 










DHK7SQ 


























7DE7SIZE 


000025 


DHKCQP 


DHKCSP 


DHKCSQ 


DHKCST 


DHKLOG 


DHKSCH 


DHKOSO 


DHKVCH 


DHKVDC 


DHKVDS 






(D 




7DE7SNSE 


000029 


DHK7CH 


DHK7SP 






















v 




7DE7SPL 


000036 


DHKCFP 
DHK7SQ 


DHKCKP 


DHKCPS 


DHKCSP 


DHKCSQ 


DHKCSO 


DMKCSY 


DHKERE 


DHKSPL 


DHKVDR 


DHKVSI 


DHKVSP 


O 


n 


7DE7STAT 


000176 


DHKCCH 


DHKCFH 


DHKCFP 


DHKCKP 


DHKCPB 


DHKCP7 


DHKCQG 


DHKCSE 


DHKCSP 


DHKCSQ 


DHKCST 


DHKCSO 


1 

B 
O 


►a 






DHKCS7 


DHKDEF 


DHKDGD 


DHKDIA 


DHKDRD 


DHKDSP 


DHKGIO 


DHKHVE 


DHKPRV 


DHKSCH 


DHKSPL 


DHKSSS 


o 






DHKTRD 


DHK7CA 


DHK7CN 


DHK7DA 


DHK7DD 


DHK7DB 


DHKYDS 


DHKVER 


DHK7 10 


DHKVSI 


DHKVSP 




Pi 


H* 


7DE7S7C 


000019 


DHK7DD 


DHK7SP 
























H 


7DE7TDSK 


000014 


DHKACO 


DHKCKP 


DHKCP7 


DHKCQG 


DHKCQP 


DHKDEF 


DHKVCH 


DHKVDC 


DHKYDR 


DHKVDS 






(P 


o 


7DE7TERH 


000011 


DHKCQG 


DHKCSP 


DHKQCN 


BHK7CH 


DHK7DS 
















o 

H 


o 


7DE7TIC 


000006 


DHK7CN 
























7DE7THAT 


000004 


DHKACO 


DHKCKP 


DHK7DS 




















O 


H« 


7DE7TRAH 


000003 


DHK7CH 
























to 

0) 


(A 


7DE7TIPC 


000169 


DHKACO 


DHKCCH 


DHKCFP 


DHKCKP 


DHKCPB 


DHKCP7 


DHKCQG 


DHKCQP 


DHKCSP 


DHKCSQ 


DHKCST 


DHKCSO 






DHKCS7 


DHKDEF 


DHKDGD 


DHKDIA 


DHKDRD 


DHKGIC 


DHKHYD 


DHKLHK 


DHKPRV 


DHKSCH 


DHKSPL 


DHKTRD 


W 








DHK7CH 


DHR7CH 


DMK7DC 


DHK7DD 


DHKYDR 


DHK7DS 


DHKVER 


DHKVIO 


DHKVSI 


DHKVSP 






(0 
Hi 




7DE7TYPE 


000146 


DMKCCH 


DMKCFP 


DHKCKP 


KHKCPB 


DHKCQG 


DHKCSB 


DHKCSP 


DHKCSQ 


DHKCST 


DHKCSO 


DHKCSV 


DHKDGD 


(D 


_* 






DHKDIA 


DHKDRD 


DMKH7D 


DHKLHK 


DHKSCH 


DHKSPL 


DHKOHT 


DHKVCH 


DHKVDR 


DHKVDS 


DHKVER 


DHKVIO 


P 


I 






DHK7SI 


DHK7SP 


DHK7SQ 




















U) 
CD 
U3 


7DE70C 
VDE70HIT 


000011 
000004 


DHKCCH 
DHK7SP 


DHKCFP 


DHKDGD 


DHKGIO 


DHK7IO 


DHK7SI 














O 



I 
u> 

o 



H 

w 

at 

< 
at 

Ui 

■sj 

o 
w 

M 

<D 
B 

f« 
O 

ua 
o 

0) 

» 
>G 

H 

o 
to* 



(D 
rt- 
(D 
M 

a 

H« 
S3 
0) 
f+ 
H« 
O 

I 
I 

< 

o 

C3 

a 

(0 



LABEL 



VDEVUSER 

VDEVVCF 

VDEVXFER 

VDEV231B 

VDEV231T 

VFAULT 

VFCBBLOK 

TFCBCHL 

VFCBCNT 

VFCBEOF 

VFCBFLAG 

VFCBLOAD 

VFCBNDEX 

VFCBSIZE 

VIRTUAL 

VMABLOK 

VMACCOUN 

VMACNT 

VMACOUNT 

VMACTDEV 

VMADSTOP 

VMAEX 

VMAEXP 

VMAFF 

VMAFFON 

VMAFPHT 

VMANAHE 

VMAPTIME 

VMASHRBK 

VMASIZE 

VMASSIST 

VMBADCRO 

VMBCAUTH 

VMBLOK 



COUNT 



000006 
000003 
000021 
000008 
000003 
000003 
000012 
000005 
000009 
000003 
000009 
000009 
000008 
000006 
000041 

000006 
000003 
000007 
000010 
000005 
000009 
000010 
000009 
000018 
000009 
000010 
000003 
000010 
000003 
000004 
000007 
000004 
000012 
000884 



REFERENCES 



VMBSIZE 000006 



DMKCFP 
DMKVCN 
DMKCKP 
DMKCCW 
DMKCCW 
DMKPRG 
DMKCSB 
DMK?SP 
DMKCSB 
DMKVSP 
DMKVSP 
DMKCSB 
DMKCSB 
DMKCSB 
DMKCCW 
DMKVSI 
DMKATS 
DMKHVD 
DMKACO 
DMKACO 
DMKDGD 
DMKCFD 
DMKBLD 
DMKCFO 
DMKCFS 
DMKCFS 
DMKATS 
DMKATS 
DMKACO 
DMKCFG 
DMKATS 
DMKATS 
DMKVAT 
DMKCFP 
DMKACO 
DMKCFG 
DMKCPS 
DMKCST 
DMKEXT 
DMKJRL 
DMKMON 
DMKPRV 
DMKSEP 
DMKTRK 
DMKVDR 
DMKBLD 



DMKLNK 

DMKCQG 
DMKCQG 
DMKCQG 
DMKPTR 
DMKVSP 

DMKVSP 



DMKVSP 
DMKVSP 
DMKVDR 
DMKCFP 

DMKCFG 
DMKLOG 
DMKCKP 
DMKCKP 
DMKGIO 
DMKCFS 
DMKCFO 
DMKSCH 
DMKCPD 
DMKCP0 
DMKCFG 
DMKCFG 
DMKAPI 
DMKVMA 
DMKCFG 
DMKCFG 

DMKVMC 
DMKALG 
DMKCFH 
DMKCP0 
DMKCSO 
DMKFRE 
DMKLNK 
DMKMSG 
DMKPSA 
DMKSNC 
DMKUDR 
DMKVDS 
DMKDIA 



DMKSCN 



DMKCSP 
DHKUNT 



DMKVSP 
DMKCQP 

DMKPGS 
DMK0S0 
DMKJRL 
DMKHVD 
DMKTHI 
DMKPGS 
DMKMON 
DMKUSO 
DHKCQR 
DMKCQR 
DMKPGS 
DMKPGS 
DMKBLD 

DMKPGS 
DMKPGS 



DMKAPI 
DMKCFM 
DMKCPV 
DMKCSV 
DMKGIO 
DMKLOG 
DMKHSW 
DMKPTR 
DMKSPL 
DHKUDU 
DMKVER 
DMKLOG 



DMKONT 
DMKSPL 



DMKVDS 



DMKDEF DMKDGD 



DMKVMA 

DMKLOG 
DMKLOG 
DMKVSI 
DMKSVC 
DMKSCH 

DMKDSP 
DMKDSP 
DMKVMA 

DMKCPI 



DMKVMA 



DMKATS 
DMKCFO 
DMKCQG 
DMKDAS 
DMKGRF 
DMKLOH 
DMKNES 
DMKQCN 
DMKSSS 
DMKUNT 
DMKVIO 
DMKOSO 



DMKDDU 
DMKSPL 



DMKLOG 
DMKMCT 



DMKLOG 



DMKBLD 
DMKCFP 
DHKCQH 
DMKDEF 
DMKGRT 
DMKLOK 
DMKNET 
DMKRGA 
DMKSTK 
DMKUSO 
DMKVMA 



DHKDIB 



DMKUSO 
DMKUSO 



DMKMCT 



DMKTMB 



DMKCCH 
DMKCFS 
DMKCQE 
DMKDGD 
DMKHVC 
DMKMCC 
DMKNLD 
DMKRGE 
DMKSVC 
DMKVAT 
DMKVMC 



DMKDSB 



DMKCCH 
DMKCFT 
DMKCQR 
DMKDIA 
DMKHVD 
DMKMCD 
DMKNLE 
DMKRNH 
DMKTCS 
DMKVCA 
DMKVSI 



DMKIOS 



DMKCDE 
DMKCKP 
DMKCQY 
DMKDIB 
DMKICE 
DHKHCH 
DMKPAG 
DHKRFA 
DMKTHI 
DHKVCH 
DMKVSP 



DMKLNK 



DMKCDM 
DMKCKS 
DMKCSB 
DMKDRD 
DMKIOF 
DMKMCT 
DMKPER 
DHKRSE 
DMKTMR 
DMKVCN 
DMKVSQ 



DMKLOG 



DMKCDS 
DMKCNS 
DMKCSO 
DMKDSP 
DMKIOG 
DHKHIA 
DMKPGS 
DMKRSP 
DMKTRA 
DMKVDA 
DMKWRM 



DMKSSS 



DMKCFC 
DMKCPB 
DMKCSP 
DMKENT 
DMKIOS 
DMKMID 
DMKPGT 
DMKSCH 
DMKTRC 
DMKVDC 



DMKVDA 



DMKCFD 
DMKCPI 
DMKCSQ 
DMKERM 
DMKISM 
DMKHNI 
DMKPRG 
DMKSCN 
DMKTRD 
DMKVDD 



O 

f 
0> 
fcr* 
<D 
M 

I 

r+ 
O 

I 

at 
o 

Oi 

C 

H 
(D 

O 

tl 

o 

w 

W 

w 

CD 
H> 
CD 
M 

a> 
» 
o 

CD 





LABEL 


COONT 


REFERENCES 


























VBCAAOTS 


000002 


DBKYBC 




























VBCACNT 


000007 


DBKYBC 




























VBCAPRTY 


000002 


DBKYBC 




























VHCAQIES 


000004 


DBKYBC 




























VBCASTAT 


000008 


DBKYBC 




























VBCBLOK 


000044 


DBKDSP 


DBKYBC 


























VBCBSIZE 


000008 


DBKYBC 




























VBCCBOSY 


000008 


DBKYBC 




























VBCCRECP 


000003 


DBKYBC 




























VBCCSTAT 


000019 


DBKDSP 


DBKVBC 


























VBCCXINT 


000008 


DBKDSP 


DBKYBC 


























VBCEFLG 


000026 


DBKYBC 




























VBCF 


000029 


DBKALG 
DBKRSE 


DBKCFB 
DBKVCN 


DBKCNS 


DBKDIA 


DBKDSP 


DHKEBC 


DBKGRF 


DBKHVC 


DBKLNK 


DBKLOG 


DBKQCN 


DHKRGA 






VBCFPNT 


000016 


DBKDSP 


DBKVBC 


























VBCFREAD 


000006 


DBKCFB 


DBKDSP 


DBKLOG 


DBKQCN 






















VBCFRUN 


000008 


DBKCFB 


DBKCFS 


DBKCQR 


DBKDSP 


DBKPRG 




















VBCFONC 


000005 


DBKYBC 




























VBCFWAIT 


000035 


DBKACO 
DBKRGA 


DBKALG 
DBKRHH 


DBKBLD 
DBKTRA 


DBKCFB 
DBKTRC 


DBKCNS 
DBKTRD 


DBKDGD 


DHKDSP 


CBKGBF 


DBKHVC 


DBKLOG 


DBKPRG 


DBKQCN 






VBCHCNT 


000012 


DBKLOG 


DBKOSO 


DBKVCH 


DBKVDC 


DBKVDS 




















¥MCHSTRT 


000062 


DBKCFB 


DBKCFP 


DBKCKP 


IIMKCPV 


DBKCQG 


DBKCSP 


DHKCSO 


DBKCSV 


DHKDEF 


DBKDIA 


DBKDSP 


DBKLOG 










DBKSCN 


DBKSPL 


DBKOSO 


DBKVCH 


DBKVCN 


DBKVDC 


DBKVDS 


DBKVIO 


DBKVSI 


DBKVSP 








VHCHTBL 


000029 


DBKBLD 


DBKCFB 


DBKCFP 


DBKCKP 


DBKCPV 


DBKCQG 


DBKCSP 


DBKCSO 


DHKCSV 


DHKDEF 


DBKDIA 


DHKDSP 










DBKSCN 


DBKSPL 


DBKOSO 


DBKVCH 


DBKVDD 


DBKVDS 


DBKVSP 












tr 




VHCKEY 


000006 


DBKVMC 


























VBCLASSA 


000012 


DBKCFC 


DBKCFB 


DBKCFO 


DBKCFS 


DBKDEF 


DBKHVD 


DBKBSG 


DBKNIT 


DBKTHI 








CD 




VBCLASSB 


000015 


DBKCFC 


DBKCFB 


DflKCFO 


DBKCFS 


DBKDEF 


DBKHVD 


DBKBSG 


DBKNET 


DBKTHI 


DBKVDC 






| 




VBCLASSC 


000014 


DBKCFC 


DBKCFB 


DBKCFO 


DBKCFS 


DBKHVD 


DBKNET 


DBKTHI 












<+ 


n 


VBCLASSD 


000018 


DBKCFC 


DMKCFB 


DBKCFO 


i:hkcfs 


DBKCQH 


DBKCQB 


DHKCSO 


DBKCSV 


DHKNET 


DBKTHI 






o 


VBCLASSE 


000011 


DBKCFC 


DBKCFB 


DBKCFO 


DBKCFS 


DBKHVD 


DBKNET 


DBKTHI 












I 




VBCLASSF 


000013 


DBKCCW 


DBKCFC 


DBKCFB 


DBKCFO 


DHKCFS 


DBKHVD 


DHKIOE 


DBKNET 


DBKTHI 








O 


o 
p* 


VBCLASSG 


000007 


DBKCFC 


DBKCFB 


DBKCFO 


DBKCFS 


DBKCQG 


DBKNET 


DBKTHI 












Pi 

a 


n 


VBCLASSH 


000002 


DBKCFC 


DBKCFB 






















CD 
O 


VBCLENA 


000008 


DBKYBC 
























CD 


YHCLEVEL 


000040 


DBKCCW 


DBKCFC 


DBKCFS 


DBKCQG 


DBKCQH 


DBKCQB 


DBKCSO 


DBKCSV 


DBKDEF 


DBKHVD 


DBKIOE 


DHKLOG 




O 






DMKBSG 


DBKNET 


DBKTHI 


DBKVDC 


















CD 


VBCBEFLG 


000001 


DBKBSS 
























o 


VBCBFONC 


000001 


DBKBSG 
























(A 

in 


W 


YBCBHDR 
YMCBID 
VBCBLEN 
VBCBLENA 


000001 
000001 
000009 
000001 


DBKBSG 
DBKYBC 
DBKBSG 
DBKBSG 


DBKVBC 






















w 

CD 

CD 


I 


YBCBBID 


000001 


DBKBSG 
























n 

CD 




to 


YBCBOSE 


000003 


DBKBSG 


























YBCBOSER 


000001 


DBKBSG 
























o 

CD 



I 

U) 

to 



H 

td 
ae 

EC 
\ 

U) 
-J 

o 
t/i 
w 



o 

IQ 
H- 
O 

01 

Pi 

•tf 
M 
O 

b* 

M 
(0 

a 

to 
r+ 

(D 
H 

B 
H- 

a 
p> 
r+ 

H" 
O 

a 
I 
I 

o 

M 
C3 

■ 
(D 



LIBEL 



VBCBVADA 

VBCOBND 

VBCOHP 

VBCONB0F 

VBCONLN 

VBCPARB 

VHCPAOTS 

VBCPFLG1 

VBCPFONC 

VBCPIDEN 

VBCPLEN 

VBCPBID 

VBCPNT 

VBCPPRTY 

VBCPRTY 

VHCPSENR 

VBCPSENX 

VBCPSBSG 

VBCPTIBE 

YMCPOID 

VBCPOSE 

VBCPOSER 

VBCPOTBR 

VBCPVADA 

VBCPVADB 

VBCPHAIT 

VBCRDS 

YBCRESP 

VBCRJCT 

VBCSBAX 

YMCSTAT 

VBCTOD 

VBCOCHT 

YHCOSE 

VBCOSER 

VBCOSTRT 

VBCVADA 

VBCVADB 

VBCXCODE 

VBCXBASK 

VBCXSTAT 

YBC01 

VBC02 

VBC03 

VBC04 



COUNT 



000001 
000010 
000005 
000006 
000004 
000003 
000001 
000005 
000001 
000002 
000003 
000001 
000019 
000003 
000003 
000002 
000002 
000001 
000010 
000006 
000003 
000007 
000019 
000007 
000001 
000007 
000006 
000013 
000001 
000001 
000018 
000006 
000012 
000003 
000020 
000062 

000009 
000002 
000004 
000002 
000012 
000003 
000001 
000001 
000001 



REFERENCES 



DBKBSG 
DBKALG 
DBKDGD 
DBKBLD 
DBKHYC 
DBKYBC 
DBKVBC 
DBKYBC 
DBKYBC 
DBKYBC 
DBKHYC 
DBKYBC 
DBKDSP 
DBKYBC 
DBKYBC 
DBKYBC 
DBKBSG 
DBKVBC 
DBKACO 
DBKCFS 
DBKYBC 
DBKYBC 
DBKCFP 
DBKYBC 
DBKVBC 
DBKCFB 
DBKACO 
DBKYBC 
DBKYBC 
DBKYBC 
DBKYBC 
DBKYBC 
DBKLOG 
DBKYBC 
DBKYBC 
DBKCFB 
DBKPRY 
DBKYBC 
DBKYBC 
DBKDSP 
DBKYBC 
DBKCFP 
DBK7BC 
DBKVBC 
DBKVBC 
DBKVBC 



DBKCFC 
DBKDSP 
DBKHVC 
DBKQCN 



DBKVBC 



DBKVBC 



DBKVBC 

DBKAPI 
DBKCQY 



DBKPSA 



DBKDSP 
DBKBON 



DBKOSO 



DBKCFP 
DBKSCN 



DBKVBC 



DBKVBC 



DBKCFG 
DBKGIO 
DBKQCN 



DBKCSU 
DMKSCH 



DBKCSV DBKHVC DBKLNK DBKQCN DBKOSO 



DBKBLD 
DBKLOG 



DHKSCH 



DHKPTR 
DHKTHI 



DBKVCH 



DHKCKP 
DBKSPL 



DHKCPI 
DBKPRY 



DBKTBR 



DBKSCH 
DBKVSP 



DBKVDC 



DBKCPV 
DBKVCH 



DBKDSP 



DBKLOG 



DBKTBR 



DBKVDS 



DBKCQG 
DBKVCH 



DBKCSE 
DBKVDC 



DBKCSO 
DBKVDS 



DBKCSV 
DHKVIO 



DBKDEF 
DHKYSI 



CBKDIA 
DBKVSP 



DBKDSP 



DBKLOG 



O 
Hi 

P> 
fcr* 
<D 
H 
I 



3! 
O 
Pj 





n 
n 
o 

W 

en 

w 

(D 
M> 
(D 
H 
CD 
» 
O 
(0 





LABEL 


COONT 


REFERENCES 


























7HC05 


000004 


DHKYHC 




























7HC06 


000003 


DHK7BC 




























7HC07 


000002 


DHK7HC 




























7HC08 


000001 


DHK7HC 




























7HC09 


000001 


DHK7HC 




























7HC10 


000001 


DMK7HC 




























7HC11 


000002 


DHK7BC 




























7HC12 


000001 


DMK7MC 




























7HC13 


000001 


DMK7HC 




























7HC14 


000001 


DHK7HC 




























7HC15 


000003 


DMK7MC 




























7HC16 


000003 


DMK7MC 




























7HC17 


000003 


DMK7MC 




























7HC18 


000001 


DMK7BC 




























VBC19 


000008 


DMK7MC 




























7HC20 


000001 


DMK7MC 




























VMDEFSTK 


000012 


DMKCPU 


DHKDSP 


DHKLOK 


DHKSTK 


DHKTHI 




















¥HDELAY 


000013 


DMKCFC 


DHKCFH 


DHKDIA 


EHKLOG 


DHKQCN 


DHKOSO 


















¥HDFTPNT 


000021 


DHKAPI 
DMK7AT 


DHKBLD 
DHK7SI 


DHKCPI 


DHKCPO 


DHKDIA 


DHKDSP 


DHKLOG 


DHKPRG 


DHKPR7 


DHKS7C 


DHKTHR 


DHKOSO 






¥MDISC 


000030 


DHKALG 


DHKCQG 


DHKCQP 


DHKCQY 


DHKJRL 


DHKLOG 


DHKHSG 


DHKHS1 


DHKPSA 


DHKQCN 


DHKOSO 


DHK7CN 






YMDIST 


000005 


DMKCKP 


DHKCQG 


DHKLOG 


DHKSPL 


DHK7DS 
















n 




YMDR0P1 


000003 


DMKSCH 
























*3 




7HDSP 


000027 


DHKDSP 


DHKPGS 


DHKPRG 


DHKPR7 


DHKPSA 


DHKPTR 


DHKSCH 


DHKTHR 










ft 




7MDSTAT 


000089 


DHKACO 
DHKTHI 


DHKCFP 
DHKTHR 


DHKCP7 
DHK7CN 


DHKDSP 
DHK7I0 


DHKIOS 
DHK7SI 


DHKPAG 


DHKPGS 


DHKPRG 


DHKPR7 


DHKPSA 


DHKPTR 


DHKSCH 


(0 
t— ' 




7HD7CNT 


000017 


DHKCQP 


DHKCSP 


DHKCSQ 


DHKCST 


DHKLOG 


DHKSCH 


DHKOSO 


DHK7CH 


DHK7DC 


DHK7DS 








7HD7STRT 


000238 


DHKALG 


DHKCCH 


DHKCCH 


DHKCFH 


DHKCFP 


DHKCFT 


DHKCKP 


DHKCPS 


DHKCP7 


DHKCQG 


DHKCQP 


DHKCSP 


7 








DHKCSQ 


DHKCST 


DHKCSD 


DHKCS7 


DHKDAS 


DHKDEF 


DHKDGD 


DHKDIA 


DHKDIB 


DHKDRD 


DHKDSP 


DHKGIO 


O 

I 


o 






DHKGRF 


DHKH7C 


DHKH7D 


DHKLOG 


DHKPR7 


DHKQCN 


DHKRGA 


DHKSCN 


DHKSPL 


DHKOSO 


DHK7CA 


DHK7CH 


*a 






DHK7CN 


DHK7DC 


DHK7DR 


DHK7DS 


DHK7I0 


DHK7SI 


DHK7SP 


DHK7SQ 










QB 


o 


7HECEXT 


000050 


DHKBLD 


DHKCDB 


DHKCDH 


DHKCDS 


DHKCFG 


DHKCFH 


DHKCFP 


DHKCFS 


DHKDSP 


DHKEXT 


DHKLOG 


DHKPRG 


O 
Pi 


H- 






DHKPR7 


DHKSCH 


DHKS7C 


DHKTHR 


DHKTRC 


DHKTRD 


DHKOSO 


DHK7 AT 


DHK7SI 








(0 


7HELIG 


000009 


DHKPTR 


DHKSCH 


DHKTHI 




















!-• 


O 


7HEPRI0R 


000006 


DHKBLD 


DHKHON 


DHKSCH 




















(D 


r+ 


7MESTAT 


000129 


DHKBLD 


DHKCDB 


DHKCDH 


DHKCDS 


DHKCFD 


DHKCFG 


DHKCFP 


DHKCFS 


DHKCPB 


DHKCPO 


DHKDGD 


DHKDRD 


O 


O 

ft 






DHKDSP 


DHKGIO 


DHKH7C 


DHKH7D 


DHKIOS 


DHKLOG 


DHKHCH 


DHKPGS 


DHKPRG 


DHKPR7 


DHKPSA 


DHKPTR 


1-1 

o 
en 


H- 






DHKRPA 


DHKS7C 


DHKTHR 


DHKTRC 


DHKTRD 


DHKODR 


DHK7AT 


DHK7CN 


DHK7I0 


DHK7SI 


DHK7SP 




(D 
(A 


7HEXTCH 


000066 


DHKCDB 


DHKCDH 


DHKCDS 


DHKCFG 


DHKCPB 


DHKDGD 


DHKDRD 


DHKDSP 


DHKGIO 


DHKH7C 


DHKH7D 


DHKIOS 


0) 






DHKHCH 


DHKPRG 


DHKPR7 


DHKPSA 


DHKS7C 


DHKTHR 


DHKTRC 


DHKTRD 


DHKODR 


DHK7CN 


DHK7I0 


DHK7SI 


td 








DHK7SP 
























ft 




7HEXTPND 


000006 


DHKDSP 


DHKPR7 


DHK7HC 




















Ml 


.a 


7HEXHAIT 


000050 


DHKACO 


DHKCFP 


DHKDGD 


DHKDSP 


DHKGIO 


DHKH7C 


DHKHCH 


DHKHCT 


DHKPRG 


DHKPR7 


DHKRPA 


DHKS7C 


» 






DHKTHI 


DHKTHR 


DHKTRA 


DHKTRC 


DHKTRD 


DHK7AT 


DHK7CN 


DHK7F.R 


DHK7I0 


DHK7HC 


DHK7SI 


DHK7SP 


(D 


U) 


YHFAOTO 


000005 


DHKCCW 


DHKCFP 


DHKCFS 


DHKCQR 



















O 


u> 


7HFBHX 


000007 


DHKCQG 


DHKDEF 


DHKLOG 


DHK7CH 


DHK7DS 
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O 


V£> 


VMFLPAG 


000009 


DMKPTR 




























VMFPRS 


000039 


DHKCDB 


DMKCDM 


DHKCDS 


DMKCFG 


DMKDSP 


DMKIOS 


DMKMCH 


DMKPRG 


DMKPSA 


DMKSYC 






(D 


H 


VMFSTAT 


000021 


DMKCCW 


DMKCFP 


DMKCFS 


DMKCQG 


DMKCQR 


DMKDEF 


DMKHVC 


DMKLMK 


DMKLOG 


DMKTRA 


DMKVCH 


DMKVDS 


I 


CO 

3C 


VHFVTMR 


000005 


DMKCFS 


DMKLOG 


DMKTRA 




















r+ 




VMGENIO 


000023 


DMKGRF 


DMKCCH 


DMKRGA 


EMKRGB 


DMKVCN 
















O 


2j 


VMGPRS 


000068 


DMKCDB 


DMKCDM 


DMKCDS 


DMKCFG 


DMKDGD 


DMKDSP 


DHKEXT 


DMKGIC 


DMKHVC 


DMKHYD 


DMKIOS 


DMKMCH 


I 
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DMKPRG 


DMKPRV 


DMKPSA 


DHKSSS 


DMKSYC 


DMKTMR 


DMKTRC 


DMKVER 


DMKVSI 








O 


u> 


VMGRFTAB 


000011 


DMKBLD 


DMKCFT 


DHKCQR 


DMKGRF 


DMKGRT 
















Pi 

(= 


o 


VMHIPRI 


000010 


DMKCFO 


DMKSCH 
























VMIDLE 


000022 


DMKACO 


DMKCCW 


DMKCFO 


DMKCFP 


DMKDGD 


DMKDSP 


DMKGIO 


DMKIOS 


DHKSCH 


DMKVCN 


DMKVIO 


DMKVSI 


(D 


CO 

en 


VMINHMIG 


000003 


DMKDEF 


DMK0SO 






















n 


VMINQ 


000031 


DMKACO 


DMKCFP 


DMKCPY 


DMKDSP 


DMKIOS 


DHKPAG 


DMKPGS 


DMKPRV 


DMKPTR 


DMKSCH 


DMKTHI 


DMKTMR 


c+ 


YHINST 


000083 


DMKHVC 


DMKHYD 


DMKMON 


DMKPRV 


DMKRPA 


DMKSVC 


DMKTMR 


DMKTRD 


DMKVSI 


DMKVSP 






o 


CD 


VHINVPAG 


000025 


DMKBLD 


DMKCDB 


DMKCDM 


DMKCDS 


DMKCFP 


DMKCPO 


DHKDSP 


DMKMCH 


DMKPGS 


DMKPRV 


DMKPTR 


DMKRPA 


(A 
to 


B 






DMKTMR 


DMKTRC 


DMKTRD 


DMKVAT 


















F« 


VMINVSEG 


000012 


DMKCDB 


DMKCDM 


DMKCDS 


DMKDSP 


DMKPRV 


DMKVAT 














pa 


O 


VMIOACTV 


000014 


DMKCFP 


DMKDSP 


DMKVIO 


DMKVSI 


















fD 


VMIOCNT 


000012 


DMKACO 


DMKCKP 


DMKDGD 


DMKGIO 


DMKMON 


DMKTHI 


DMKVSI 












a> 


O 


VMIOINT 


000017 


DMKCFM 


DMKCFP 


DMKCPB 


DMKDSP 


DMKPRV 


DHKSCH 


DMKSSS 


DMKVCN 


DMKVIO 


DMKVSI 


DMKVSP 




n 
(t> 

a 


0> 


VMIOLOG 


000008 


DMKCCH 


DMKCFP 


DMKPRV 




















» 


VMIOPND 


000017 


DMKCFM 


DMKCFP 


DMKCPB 


DMKDSP 


DMKPRG 


DMKPRV 


DMKSSS 


DMKVAT 


DMKVCN 


DMKVIO 


DMKVSI 


DMKVSP 


o 


Pi 


VMIOWAIT 


000034 


DMKCFG 


DMKCFP 


DMKDGD 


DMKDIB 


DMKDSP 


DMKGIC 


DMKHVC 


DMKICS 


DMKPRG 


DMKTHI 


DMKVCA 


DMKVIO 


CD 


»tJ 






DMKVSI 


























tt 


VMISAM 


000005 


DMKCCW 


DMKCFS 


DMKCQR 


DMKLOG 




















O 


YHKILL 


000027 


DMKALG 


DMKCDB 


DMKCDM 


DMKCFM 


DMKCFP 


DMKDIA 


DMKDSP 


DHKJRL 


DMKLNK 


DMKLOG 


DMKMCH 


DMKMCT 








DMKMSG 


DMKQCN 


DMKOSO 


DMKVDD 




















(D 


VMLINS 


000006 


DMKACO 


DMKMON 


DMKTHI 


DMKVSP 




















5 


YHLOCK 


000042 


DMKBLD 


DMKCPO 


DMKDSP 


DMKFRE 


DMKIOS 


DMKLCK 


DMKHCH 


DMKPAG 


DMKPTR 










O 


VMLOCKER 


000006 


DMKBLD 


DMKIOS 


DMKLOK 


DMKPTR 




















ro 

CD 


VHLOGOFF 


000046 


DMKACO 


DMKCDB 


DMKCDM 


DMKCFG 


DMKCFH 


DMKCFH 


DMKCFP 


DMKCNS 


DMKCPV 


DMKDGD 


DMKDIA 


DMKDSP 








DMKGRF 


DMKMCT 


DMKMSG 


DMKPGS 


DMKQCN 


DMKRGA 


DMKRGB 


DMKSCN 


DMKTRC 


DMKTRD 


DMKOSO 


DMKVCA 




M 






DMKVCN 


DMKVDD 


DMKVMA 






















a 

H* 


YHLOGON 


000033 


DMKBLD 


DMKCFC 


DMKCFM 


DMKCKP 


DMKCNS 


DHKCPI 


DMKCPV 


DMKGRF 


DMKLNK 


DMKLOG 


DMKMCT 


DMKMON 




S3 






DMKQCN 


DMKRGA 


DMKRNH 


DMKSCN 


DMKUSO 


DMKVDD 
















P> 


fMLONGWT 


000002 


DMKACO 


DMKSCH 


























YHLOPRI 


000003 


DMKDGD 


DMKGIO 


DMKSCH 






















O 


YHLSTPRC 


000004 


DMKDSP 


DMKMON 
























a 
i 


YHHACCOH 


000005 


DMKCFS 


DMKCPV 


DMKCQR 


DMKLOG 




















i 
1 


YHHADDR 


000014 


DMKCFS 


DMKDSP 


DHKHCH 


DMKPRV 


DMKPTR 


DMKRPA 


DMKTRA 














< 


YMHCODE 


000013 


DMKBLD 


DMKCFS 


DMKCQR 


DMKHVC 


DMKLOG 


DMKQCF 


DMKVMI 














o 


YHHCPAST 


000003 


DMKCFO 


DMKLOG 
























a 


YMMCPENY 


000014 


DMKCFT 


DMKCNS 


DHKCQR 


DMKGRF 


DMKLOG 


DMKRGA 


DMKRNH 














B 


VHHCR6 


000039 


DMKCFD 


DMKCFO 


DMKCFS 


DMKCQR 


DMKDSP 


DMKLOG 


DMKMCH 


DMKPRV 


DMKPTR 


DMKRPA 


DMKSVC 


DMKTRA 




to 


YMMFE 


000011 


DMKAPI 


DMKCFS 


DMKCPI 


DMKCQR 


DMKDSP 


DMKLOG 
















-* 


YMHICRO 
YHMICSVC 


000009 
000007 


DMKBLD 
DMKCFD 


DMKCFS 
DMKCFP 


DMKDSP 
DMKCFS 


DMKLOG 
DMKLOG 


DMKPRV 
DMKSYC 


DMKOSO 
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REFERENCES 



VNHIMSG 000014 
VHMLEVEL 000062 



H 
(D 
O 
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M 
H- 
(B 
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I 

U) 

VO 

tn 



VMMLINED 

VHMLVL2 

VMMNOSK 

VMMPROB 

VHMSGON 

VMMSHADT 

VMHSTHP 

VNMSVC 

VMMTEXT 

VMMVTMR 

VHM360 

VHNDCNT 

VMNEWCR0 

VMNORON 

VMNOTRAN 

VMNPWOCL 

VMNSHR 

VMOSTAT 



000010 
000014 
000002 
000003 
000015 
000002 
000005 
000009 
000014 
000016 
000003 
000007 
000011 
000006 
000005 
000004 
000003 
000157 



VMPAGES 000051 

VMPAGEX 000006 
VMPA2APL 000006 
VMPDISK 000010 
VMPDROM 000011 
VMPEND 000060 



VMPERCM 

VNPERPND 

VMPF0NC 

VMPGPND 

VMPGPNT 

VMPGREAD 

VMPGRINQ 

VMPGNAIT 

YMPGHRIT 

VMPNCH 

VHPNT 



000014 
000024 
000010 
000007 
000006 
000010 
000004 
000014 
000005 
000006 
000061 



VMPRGIL 000012 
VMPRGPND 000003 



DMKCFS 
DMKBLD 
DMKMID 
DMKBLD 
DMKCFS 
DMKDSP 
DMKDSP 
DMKBLD 
DMKDSP 
DMKCFM 
DMKAPI 
DMKBLD 
DMKCFS 
DMKCFS 
DMKDSP 
DMKCDB 
DMKACO 
DMKCFP 
DMKHVC 
DMKCFG 
DMKALG 
DMKCQG 
DMKLOH 
DMKQCN 
DMKATS 
DMKODR 
DMKCFP 
DMKCFG 
DMKATS 
DMKATS 
DMKCFH 
DMKSTK 
DMKDSP 
DMKDSP 
DMKCFS 
DMKCFP 
DMKCFP 
DMKACO 
DMKHON 
DMKCFP 
DMKACO 
DMKACO 
DMKAPI 
DMKMID 
DMKDSP 
DHKPRG 



DMKCQR 
DMKCFG 
DHKHSG 
DMKCFS 
DMKCQR 

DHKPRV 
DMKCFS 

DMKCFT 
DMKCFD 
DMKCFS 
DMKCQR 
DMKLOG 
DMKPTR 
DMKCDM 
DMKDSP 
DMKCFS 
DMKLNK 
DMKPGS 
DMKATS 
DMKCQP 
DMKLOK 
DMKRGA 
DMKBLD 
DMKVMA 
DMKCFS 
DMKCPB 
DMKCPD 
DMKCPO 
DMKCFM 
DMKSVC 
DMKPRG 
DMKPER 
DMKCQY 
DMKDSP 
DMKDSP 
DMKCKP 
DMKPTR 
DMKCPO 
DMKMON 
DHKMON 
DMKBLD 
DMKMON 
DMKPRG 



DMKCSO DMKCSV DMKDEF DMKLOG DMKVDD 

DMKCFM DMKCFS DMKCFT DMKCNS DMKCPV DMKCQR 

DMKQCN EMKRGA DMKRNH DMKSPL DMKOSO DMKVCN 

DMKCQR DMKGRF DMKLOG DMKMSG DMKRGA DMKVCN 

DMKCSO DMKCSV DMKDEF DMKLOG DMKVDD 



DMKCQR DMKCSV DMKLOG DMKMID DMKMSG DMKSPL 



DMKQCN 
DMKCFS 
DMKCQR 
DMKDSP 

DMKOSO 
DMKCDS 
DMKRPA 
DMKCQR 
DMKLOG 

DMKCCW 
DMKCQR 
DMKMCH 
DMKRNH 
DMKCPI 

DMKCQR 
DMKGRF 
DMKMON 
DMKMON 
DMKCFP 
DMKTHI 
DMKPRV 
DHKPRG 
DMKGRF 
DMKPRV 
DMKVAT 
DMKMON 
DMKSCH 
DMKDSP 
DMKPTR 
DMKTHI 
DMKCFO 
DMKMSG 
DMKPRV 



DMKVCN 
DMKCPI 
DMKHVC 
DMKLOG 



EMKDSP 
DMKSCH 
DMKVSI 



DMKCDB 
DMKCQY 
BMKMCT 
DMKRSE 
DMKCPO 

DHKPRG 
DMKHVD 
DMKPGS 
DMKPGS 
DMKCPB 
DMKTMR 
DMKTMR 
DMKPRV 
DMKRGA 
DMKVAT 

EMKPTR 

DMKPTR 
DMKTHI 
EMKVSP 
DMKCKP 
DMKSCH 
DMKTMR 



DMKCQR 
DMKLOG 
DMKMCH 



DMKPRV 



DMKCDM 
DMKCSO 
DMKMSG 
DMKOSO 
DMKCPV 

DMKVAT 
DMKRGA 
DMKPGT 
DMKPGT 
DMKCPO 
DMKTRC 

DMKSVC 
DMKOSO 



DMKSCH 
DMKRPA 



DMKCPO 
DMKTHI 
DMKVAT 



DMKLOG 
DMKMSG 
DMKPTB 



DMKVAT 



DMKCFC 
DMKDIA 
DMKMSW 
DMKVAT 
DMKDSE 



DMKTHI 
DMKTHI 
DMKDSE 
DMKVAT 

DMKTMR 



DMKTHI 
DMKTHI 



DMKCPV 
DMKOSO 



DMKSVC 

DMKQCN DMKVMI 

DMKRPA DHKTRA 



DMKCFG 
DMKDSP 
DMKNES 
DMKVCN 
DMKMON 



DMKLOK 
DMKVCN 



DMKTRC 



DMKOSO 



DMKCFM 
DMKGBF 
DMKNET 
DMKVEA 
DMKPGS 



DMKPER 
DMKVIO 

DMKVAT 



DMKVAT 



DMKCSV 



DMKOSO 



DMKGRF DMKHVC 



DMKLOG 



DMKCFP 
DMKHVC 
DMKPGS 
DMKVDD 
DMKPTR 



DHKPRG 
DMKVSI 



DMKCFS 
DMKJRL 
DMKPRG 
DMKVDS 
DMKRPA 



DMKPRV 
DMKVSP 



DMKCNS 
DMKLNK 
DMKPSA 
DMKVSQ 
DMKSCH 



DMKSCH 



DMKCPO 
DMKLOG 
DMKPTR 

DMKTHI 



DMKSSS 



DMKCQP DMKCQR DMKCQY DMKDIA DMKLOG DMKMCT 
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LABEL 


COUNT 


REFERENCES 






















VMPRIDSP 


000009 


DMKCFM 


DMKDSP 


DMKHYC 


DMKSCH 


DMKVCN 


DHKVIC 














VMPRRCT 


000006 


DMKDSP 


DMKSTK 






















VMPSTAT 


000107 


DMKBLD 


DMKCCH 


DMKCDB 


DMKCDM 


DMKCDS 


DMKCFG 


DMKCFH 


DMKCFO 


DMKCFP 


DMKCFS 


DMKCPB 


DHKCQG 






DMKCQR 


DMKDEF 


DMKDIA 


DMKDRD 


DMKDSP 


DMKEXT 


DMKHVD 


DMKLNK 


DMKLOG 


DMKMON 


DHKPGS 


DMKPRG 






DMKPRY 


DMKPTR 


DMKSCH 


DMKSVC 


DMKTMR 


DMKTRC 


DHKOSO 


DMKVAT 


DMKVDC 


DMKVMC 


DMKVSI 




VHPSW 


000264 


DMKBLD 


DMKCDB 


DMKCDM 


DMKCDS 


DMKCFC 


DMKCFG 


DHKCFH 


DMKCFM 


DMKCFP 


DMKCFS 


DMKCPB 


DHKDGD 






DMKDRD 


DMKDSP 


DMKGIO 


DMKHVC 


DMKHVD 


DMKIOS 


DMKLOG 


DMKMCH 


DMKMON 


DMKPRG 


DMKPRV 


DHKPSA 






DMKSSS 


DMKSVC 


DMKTMR 


DHKTRA 


DMKTRC 


DMKTRD 


DMK0DR 


DMKOSO 


DMKVAT 


DMKVCN 


DMKVER 


DMKVIO 






DMKVMC 


DMKVSI 


DMKYSP 




















VMPSWAIT 


000005 


DMKDSP 


DMKSCH 


DHKTHI 




















VMPSWDCA 


000003 


DMKALG 
























VMPSWDCT 


000019 


DMKALG 


DMKHVD 


DMKJRL 


DMKLNK 


DMKLOG 
















VMPXINT 


000020 


DMKCFP 


DMKCPB 


DMKDSP 


DMKGRF 


DMKPRV 


DMKRGA 


DMKSCH 


DMKTMR 


DMKVMC 








VMQBPNT 


000007 


DMKDSP 


DMKSCH 






















VMQFPNT 


000019 


DMKDSP 


DMKSCH 


DMKTHI 




















VMQLEVEL 


000048 


DMKBLD 


DMKCFO 


DMKDGD 


EHKDSP 


DMKGIO 


DMKMOH 


DHKPAG 


DMKSCH 


DMKTHI 


DMKTMR 


DHKOSO 




VMQPRIOR 


000006 


DMKMON 


DMKSCH 






















VMQSEND 


000008 


DMKDSP 


DHKPSA 


DMKSCH 




















VMQSTAT 


000026 


DMKCFG 
DMKOSO 


DHKCFM 
DMKVCN 


DHKCPB 
DMKVIO 


EMKDEF 


DMKDSP 


DHKGRF 


DMKHVC 


DMKHVD 


DMKLOG 


DMKQCN 


DMKRGA 


DHKSCH 


VMQ1 


000016 


DMKMON 


DMKPAG 


DMKSCH 


DMKTHI 


DMKTMR 
















VMRBSC 


000007 


DMKQCN 


DMKVCN 






















VMRDINQ 


000003 


DMKMON 


DMKSCH 






















VMREAL 


000005 


DMKBLD 


DMKDEF 


DHKLOG 


DMKPRV 


















VMRON 


000014 


DMKCFS 


DMKCQR 


DMKDSP 


DMKLOG 


DMKPTR 


DMKSCH 


DHKTRA 












VMRPAGE 


000006 


DMKCFO 


DMKPTR 


DMKSCH 


DHKOSO 


















VMRPRIOR 


000002 


DMKSCH 
























VMRSTAT 


000231 


DMKACO 


DMKALG 


DMKBLD 


DMKCCN 


DMKCDB 


DMKCDM 


DMKCFC 


DHKCFG 


DMKCFH 


DMKCFM 


DMKCFO 


DHKCFP 






DMKCKP 


DMKCNS 


DMKCPI 


DMKCP0 


DMKCPV 


DMKDGD 


DMKDIA 


DMKDIB 


DHKDSP 


DMKGIO 


DMKGRF 


DHKHVC 






DMKIOS 


DMKLNK 


DMKLOG 


DMKMCH 


DHKMCT 


DMKMON 


DMKMSG 


DMKPGS 


DMKPRG 


DMKPRV 


DMKPTR 


DHKQCN 






DMKRGA 


DMKRGB 


DMKRNH 


DHKRPA 


DMKSCH 


DHKSCN 


DHKSVC 


DMKTHI 


DMKTMR 


DHKTRA 


DMKTRC 


DHKTRD 






DHKUSO 


DMKVAT 


DMKYCA 


DMKVCN 


DMKVDD 


DMKVEB 


DHKVIO 


DMKVHA 


DMKVMC 


DMKVSI 


DMKVSP 




VNRUN 


000024 


DMKDSP 


DMKIOS 


DMKPRV 


DMKSCH 


DMKTHI 


DMKVCA 














YMSEG 


000270 


DMKAPI 


DMKATS 


DMKBLD 


DMKCCH 


DMKCCW 


DMKCDB 


DMKCDM 


DMKCDS 


DMKCFD 


DMKCFG 


DHKCFH 


DMKCFP 






DMKCFS 


DMKCKS 


DMKCNS 


DHKCPB 


DMKCPI 


DHKCPS 


DMKCPU 


DMKCPV 


DMKCSE 


DMKCSO 


DHKDGD 


DMKDRD 






DMKDSP 


DMKERN 


DMKEXT 


DMKGIO 


DMKGRF 


DMKGRT 


DMKHVC 


DMKHVE 


DMKIOG 


DMKIOS 


DMKISM 


DMKLOG 






DMKMCC 


DMKMCH 


DHKHIA 


DMKMNI 


DMKMON 


DMKNLD 


DHKNLE 


DHKPGS 


DMKPRG 


DMKPRV 


DHKPTR 


DMKQCN 






DMKRGA 


DMKRGB 


DMKRSP 


DMKSCH 


DMKSEP 


DMKSNC 


DMKSPL 


DMKSSS 


DHKSVC 


DMKTCS 


DMKTMR 


DHKTRA 






DMKTRC 


DMKTRD 


DMKTRK 


DMKDDR 


DMK0D0 


DMKOSO 


DMKVAT 


DMKVCH 


DMKVCN 


DHKVDR 


DMKVER 


DMKVIO 






DMKVHA 


DMKYMC 


DMKVSI 


DHKVSP 


DMKVSQ 


DMKHRM 














YMSEGDSP 


000002 


DMKBLD 
























YMSHADT 


000008 


DMKDSP 


DMKYAT 






















YNSHR 


000027 


DMKATS 
DMKOSO 


DMKCCN 
DMKYAT 


DMKCDB 


DMKCDM 


DMKCFG 


DMKCP0 


DMKDSP 


DMKLCK 


DMKPGS 


DMKPRG 


DHKPSA 


DMKPTR 


VMSHRPRC 


000006 


DMKATS 


DMKCFG 


DMKCP0 


DMKLOK 


DMKVMA 
















VMSHRSYS 


000009 


DMKATS 


DMKCFD 


DHKCFG 


DMKPGS 
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VMSIZE 000032 



O 
►d 

O 
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M 
<D 
O 
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(D 



I 



VHSLEEP 

VMSMSGON 

VMSPMFLG 

VMSPMON 

VMSTEALS 

VMSTKCNT 

VMSTKO 

VMSTMPI 

VMSTMPT 

VMSTOR 



000011 
000003 
000006 
000004 
000005 
000015 
000010 
000010 
000007 
000028 



YMSVCPMD 000002 
VMSWPMIG 000002 
VMSYSOP 000021 

VMTCDEL 000006 
VMTERM 000049 



VMTESCP 
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• Entry Points for CP Commands 

• CP Wait State Codes 

• Function Codes for DIAGNOSE Instructions 
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Entry Points for CP Commands 



The following table is a list of CP commands and the modules that gain 
control to perform their functions. 



r~ 1 
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T 


I Command 


Entry Label 


1 
J 


J- 




i 


| ACNT 


DMKCPVAC 




| ADSTOP 


DMKCFDAD 




I ATTACH 


DMKVDAAT 




I ATTN 


DMKCFCRQ 




! ADTOLOG 


DMKALGON 




j BACKSPAC 


DMKCSOBS 




I BEGIN 


DMKCFCBE 




I CHANGE 


DMKCSUCH 




| CLOSE 


DMKCSPCL 




| COUPLE 


DMKDIACP 




! CP 


DMKCFM 




I DCP 


I DMKCDBDC 




I DEFINE 


DMKDEFIN 




! DETACH 


BMKVDDDE 




I DIAL 


DMKDIAL 




I DISABLE 


DMKCPVDS 




| DISCONN 


DMKUSODS 




| DISPLAY 


DMKCDBDI 




| DMCP 


DMKCDMDM 




j DRAIN 


DMKCSODR 




I DUMP 


DMKCDMDU 




I ECHO 


DMKMSGEG 




I ENABLE 


DMKCPVEN 




I EXTERNAL 


DMKCPBEX 




I FLUSH 


DMKCSOFL 




| FORCE 


DMKUSOFL 




I FREE 


DMKCSPFR 




I HALT 


DMKCPSH 




I HOLD 


DMKCSPHL 




I INDICATE 


DMKTHIEN 




I IPL 


DMKCFGIP 




I LINK 


DMKLNKIN 




I LOADBUF 


DMKCSBLD 




( LOADVFCB 


DMKCSBVL 




I LOCATE 


DMKCFDLO 




I LOCK 


DMKCPVLK 




| LOGOFF 


DMKUSOLG 




I LOGON 


DMKLOGON 




I MESSAGE 


DMKHSGMS 




I MONITOR 


DMKMCCCL 




I NETWORK 


DMKNETWK 




I NOTREADY 


DMKCPBNR 





j Command | Entry Label 
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1 


I ORDER 




DMKCSUOR | 


| PURGE 




DMKCSUPU | 


| QUERY* 




DMKCFCQU | 


I READY 




DMKCPBRY | 


! REPEAT 




DMKCSORP j 


I REQUEST 




DMKCFCRQ | 


I RESET 




DMKCPBRS | 


I REWIND 




DMKCPBRW | 


| SAVESYS 




DMKCFHSV | 


I SET* 




DMKCFCSE | 


I SHUTDOWN 




DMKCPSSH | 


| SLEEP 




DMKCFCSL | 


1 SMSG 




DMKMSGSM | 


• SPACE 




DMKCSOSP ! 


I SPOOL 




DMKCSPSP | 


I START 




DMKCSOST | 


I STCP 




DMKCDSCP | 


I STORE 




DMKCDSTO | 


| SYSTEM 




DMKCPBSR | 


I TAG 




DMKCSTAG | 


| TERMINAL 




DMKCFTRM | 


I TRACE 




DMKTRACE | 


| TRANSFER 




DMKCSUTR | 


\ UNLOCK 




DMKCPVUL | 


i VARY 




DMKCPSRY | 


| WARNING 




DMKMSGWN | 


j 


q 


DMKCFM | 
I 


t 




I 


I 1 Major operand 


decode of QUERY | 


I and SET is 


by 


a scan table in ! 


j DMKCFMQD. 


Depending on the I 


| operand ma 


tch 


, DMKCQP, DMKCQG,| 


| DMKJRL, oi 


DMKCQR is called \ 


| for QUERY. 


The respective I 


I entry points « 


ire DMKCQPRV, | 


| DMKCQGEN, 


DMKJRLQU, and | 


I DMKCQREY. 


For 


SET, DMKCFS, | 


| DMKJRL, or 


DMKCFO is called. | 


I Respective 


entry points are I 


| DMKCFSET, 


DHKJRLSE, and I 


I DMKCFOEX. 







Figure 25. CP Commands and Their Module Entry Points 



CP Wait State Codes 



A wait state is produced by one of the following modules: 



DMKCCH 
DMKCKP 
DMKCPI 
DMKDMP 



DMKMCH 
DMKPAG 
DMKSAV 
DMKWRM 
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When a wait state occurs, the Program Status Word (PSW) is displayed at 
the operator's console in the following format: 

xxyyyyyyzzzzzwww 

where : 

xxyyyyyy is the left half of the program status word. This half may be 
either: 

03yyyyyy Valid wait condition. The system is waiting for 
work. 

OOyyyyyy System wait caused by an error condition. 

zzzzzwww is the right half of the program status word. The wait state 
code is found in the right half of the PSW when the CPU is in 
the wait state. The wait state code, www, indicates the error 
condition. 

Wait 

Code Explanation 

001 The machine check handler found an unrecoverable failure. 
Probable hardware error. 

002 The channel check handler found an unrecoverable failure. 
Probable hardware error. 

003 A system failure occurred before a valid warm start was performed. 

004 This wait state code is loaded by DMKDMP when a console, or an 
output device is not operational, or when a console or output 
device produces an inexplicable error status. Probable hardware 
error. 

005 DMKCPI could not find an operational primary or alternate console. 
Probable hardware error. 

006 This is a normal wait when a system shutdown is completed. 

007 A program check, a machine check, or a permanent I/O error was 
found by the checkpoint program. 

008 Checkpoint and system shutdown are complete. If the system is 
running under an alternate console, error messages DMKCKP910I, 
DMKCKP911W, DMKCKP960I, and DMKCKP961I are not displayed. 

009 An error condition occurred that prevents a warm start. 

If the system is running under an alternate console, error 
messages DMKCKP910I and DMKCKP911W are not displayed. 
00A A machine check occurred while DMKSAV was attempting to save or 
restore a page image copy of the nucleus on a SYSRES device. 
Probable hardware error. 

00B A machine check occurred before initialization was complete. 

00C An attempt was made to IPL from a disk that did not contain a 
system. Thus, the wait state code 00C entered on disk by the 
Format/Allocate program is encountered. 

00D The machine size defined during system generation is greater than 
the real machine size, or a hardware error has occurred which 
inhibits VM/370 from using the required storage. 
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OOF Hardware errors are being received on VH/370 paging device (s) . 
The wait state that causes this code is preceded by message 

DMKPAG415E CONTINUOUS PAGING ERRORS FROM DASDXXX 

010 The SYSRES device, on which DMKSAY is attempting to write a page 
image copy of the nucleus, is not mounted or not ready. 

011 An unrecoverable error, other than a machine check, occurred while 
DHKSAV attempted to write a page image copy of the nucleus on the 
SYSRES device. 

012 The normal wait state code loaded by DHKSAV when it has completed 
loading the nucleus. 

013 The machine check handler encountered an unrecoverable error on 
the attached processor. Probable hardware error. 

015 A SIGP issued to the attached processor during system 
initialization by DMKCPI or DMKAPI was unsuccessful. 

027 An unrecoverable I/O error occurred or system input is incorrect. 
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CP Abend Codes 

The CP abends, their causes and required actions are listed in the IBM 
VM/370 Syst em Messages. 
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Function Codes for DIAGNOSE Instructions 



Figure 26 indicates the DIAGNOSE codes used in VM/370 and gives a brief 
explanation of their uses. 



r '" 

i Function 

j Code 


Class 


i 

Function 


| DKKHVC 
I Label 


i DSKBVD | 
I Label | 


I 000 


G 


Store extended identification 
code. 




I HVDSTIDX | 


I 004 


C,E 


Examine data from real storage. 




I READCPC | 


I 008 


G 


Execute VM/370 CP command. 


HVCONFN 




I OOC 


G 


Pseudo-timer facility. 


HVCHRON 




I 010 


G 


Release virtual storage pages. 


HVCPGRL 




I 014 


G 


Manipulate input spool files. 




I HCDSPRD | 


I 018 


G 


Standard DASD I/O. 


HVCDISK 




| 01C 


F 


Clear error recording area. 




HVDLRER | 


I 020 


G 


General virtual I/O 
interruptions. 


HVCFAKE 




i 024 


G 


Virtual device type inquiry. 




HVDDTYP } 


I 028 


G 


Dynamic TIC modification. 


HVCDCPM 




| 02C 


C,E,F 


Get DASD address of error 
recording and number of cylin- 
ders allocated for error record- 
ing. 




HVDEREP1 | 


| 030 


C,E,F 


Read a page of error recording 
data. I 




HVDEREP2 | 



Figure 26. Function Codes for DIAGNOSE Instruction (Part i of 2) 
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r 

I Function 

| Code 


Class 


Function 


DMKHVC 
Module 


DMKHVD 
Module 


I 034 


C,F 


Reads the system dump spool 
file. 




HVDRSDF 


| 038 


C,E 


Reads the system symbol table. 




HVDRDSYM 


| 03C 


A,B,C 


Dynamically updates the VM/370 
directory. 




HVDDIRCT 


I 040 




Reserved for IBM use. 


HVCEXIT 




| 044 




Reserved for IBM use. 


HVCEXIT 




| 048 




Reserved for IBM use. 


HVCEXIT 




I 04C 


any 


Generate accounting cards. 




HVDACCT 


I 050 


A r B,C 


Saves 3704/3705 control program 
image. 




HVD3705 


I 054 




Enable or disable external 
interruptions. 




HVDEXPA 


I 058 


G 


Virtual console interface for 
3270. 


HVCGRAF 




I 05C 




Edit message according to EMSG 
settings. 


HVCEMSG 




I 060 




Provide virtual machine storage 
size. 


HVCSTOR 
HVCSTOR 




I 064 




Load, find, or purge a named 
system. 


HVCSYS 




I 068 


6 


Virtual Machine Communication 
Facility. 


HVCVMCF 




I 07 4 


A,B,C 


Loads a 3800 named system 
into virtual storage 




HVD3800 


I 078 


any 


MSS communication 


HVCSSS 




I 084 


B 


Updates in-place a VM/370 di- 
rectory control statement in 
its online control block form. 


DMKDDD 




I 100 




Start of functions specified by 
a user . 


HVCDSER 





Figure 26. Function Codes for DIAGNOSE Instruction (Part 2 of 2) 
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Appendix A: VM/370 Extended 
Control-Program Support 



VM/3/0 Extended Controi-Prograrn Support (ECPS) 

VM/370 Extended Control-Program Support (ECPS) consists of three 
hardware— assisted parts: 

1. Control program assist (CP assist) - defines new hardware 
instructions to assist CP routines and functions or, in two cases, 
as new interpretations of existing VM/370 instructions. CP assist 
does not operate in a VM/370 system that runs under VM/370. 

2. Expanded virtual machine assist — provides an expansion of the 
existing virtual machine assist. 

3. Virtual interval timer assist - provides a more accurate hardware 
updating of the interval timer for the virtual machine. 

See VM/370 Planning and System Generation Guide for a list of the 
processors on which ECPS is available, 

ECPS INTERACTION WITH OTHER FUNCTIONS 

• Virtual machine assist — The expanded virtual machine assist can be 
enabled only if virtual machine assist is also enabled. 

• Program event recording - No PER events are recognized by CP assist. 
Virtual machine assist does recognize PER events for certain 
instructions. PER events are not recognized during the updating of 
the virtual interval timer. 

• VS1 assist - VM/370 ECPS and VS1 assist do not interfere with each 
other. 

• DOS emulator — If the DOS emulator is active, virtual machine assist 
is disabled. CP assist and the virtual interval timer assist are not 
disabled if the DOS emulator is active. 



CONTROL BY CONTROL REGISTER 6 AND MICBLOK ASSIST CONTROL FIELD 

The contents of control register 6 exercise overall and absolute control 
over virtual machine assist, CP assist, expanded virtual machine assist, 
and virtual interval timer assist. Values in control register 6 share 
control of functions provided by expanded virtual machine assist with 
the setting of bits in the MICBLOK* s assist control field. The use of 
the assist control field is described later on under the topic "Expanded 
Virtual Machine Assist." 

The following table defines the contents of control register 6: 

lii Description 

Virtual machine assist enabled if on, disabled if off 

1 Virtual machine in problem state if on, in supervisor state if 

off 
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2 ISK and SSK instructions not allowed if on, allowed if off 

3 System/360 instructions only if on, System/370 instructions if 
off 

4 Virtual SVC interrupts not allowed if on, allowed if off 

5 Shadow table fixup allowed if on, not allowed if off 

6 Control program assist enabled if on, disabled if off 

7 Virtual interval timer support enabled if on, disabled if off 
8-28 Real address of virtual machine pointer list 

29-31 Unused, must be zero 

Summary of Hardware Assist Control 

The following chart summarizes the control by control register 6 of 
virtual machine assist, extended virtual machine assist, CP assist, and 
the virtual interval timer assist: 



r 
i 


Virtual Control 
Machine Program 
Assist Assist 
Bit Bit 6 


Virtual 

Interval 

Timer 

Assist Enabled 

Bit 7 Assists 


System 

Operator 

Command 


Oser I 
Command | 


r 













None 


B, D 














1 


None 


* 









1 







CP assist 


B, C 









1 




1 


CP assist 


* 






1 










Virtual machine assist 


A, D 


E, NOTHR | 




1 







1 


Virtual machine assist, 
virtual interval timer 
assist 


A, D 


E, TMR | 




1 


1 







Virtual machine assist, 
CP assist, expanded 
virtual machine assist 


A, C 


E, NOTMR | 


i 


1 


1 




1 


Virtual machine assist, 
CP assist, expanded 
virtual machine assist, 
virtual interval timer 
assist 


A, C 


E, TMR | 
1 


r 


* Not possible l 
A indicates SET 
B indicates SET 
C indicates SET 
D indicates SET 
E indicates SET 


*ith VM/370 
SASSIST ON 
SASSIST OFF 
CPASSIST ON 
CPASSIST OFF 
ASSIST ON With TMR or NOTMR as 


indicated 


1 



I 
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VIRTUAL MACHINE POINTER LIST 

The virtual machine pointer list (MICBLOK) is a 24-byte area that starts 
on a doubleword boundary and contains eight fullwords. Control register 
6 contains an address that points to the beginning of the virtual 
■achine pointer list. The address is formed by concatenating bits 8 
through 28 of control register 6 with three low-order zero bits. All 
storage accesses to the virtual machine pointer list are done with real 
addresses and with a storage protect key of 0. 

The following table defines the fullwords at the specified offsets 
into the virtual machine pointer list. The usage of the workspace 
pointer and the workspace itself is implementation-dependent. The usage 
of the pointer and the workspace is not further defined in this 
document. 

Offset Definition 

♦0 Real segment table pointer 

+4 Virtual control register pointer 

+8 Virtual PSH pointer 

+12 Workspace pointer 

♦16 Virtual interval timer pointer 

+20 Assist control field 

+24 Reserved for IBM use 



TRACE TABLE ENTRIES 

The first bit of each VM/370 trace table entry generated by ECPS is set 
I to one (1). Information about VM/370 trace table entries is contained 
I in the IBM VM/370 System Programmer's Guide. 



RELATIONSHIPS BETWEEN HARDWARE ASSISTS 

Figure 27 illustrates the possible ways of running a virtual machine 
with various combinations of hardware assists and how the SET command 
affects their operation. 
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I Operator loads VM/370 



II 



j Hardware assist status: | 

I CP assist on, j 

j virtual machine assist | 

I on, I 

I expanded virtual machine | 

| assist on. j 

| virtual interval timer | 

I assist on j 

t j 



j These hardware assists are on 

| after VM/370 is loaded on the 

I following machines: System/370 Models 

| 135-3, 138, 145-3, and 148 

i 



I Class A (operator) com- | 

j mands possible before a j 

I virtual machine user is j 

I dispatched. j 



II 



| SET CPASSIST OFF 
| SET CPASSIST ON 
| SET SASSIST OFF 
| SET SASSIST ON 



I Operator issues hardware |- 
I assist commands I 

i 1 



I If no operator hardware | 
j assist commands are j 
I issued, go to part 4 (F) j 



II 



i 1 

I F | 

i 1 

Part 4 



Operator issues 
SET CPASSIST OFF 



Results: 



I ator hardware as- 
| sist commands are 
I issued, go to 
| part 2 (B) 



CP assist is cff, 

expanded virtual 

machine assist is 

off, 

virtual machine 

assist is on 



I If no more oper- | 



I Operator issues I 
| SET SASSIST OFF | 



I I 



I I 



Results: 



I CP assist is on, I 

I expanded virtual j 

I machine assist is | 

I off, | 

I virtual machine | 

assist is off | 

I virt. intv. timer | 

I assist is off | 



I If no more oper- | 

j ator hardware as- | 

I sist commands are | 

I issued, go to j 

I part 3 (D) I 



I Operator issues | I Operator issues | 



| SET CPASSIST ON 

i _ 



I A I 
i 1 

Part 1 



| | SET S1SSIST ON 

j i . 



I A | 

i j 

Part 1 



Figure 27. Hardware Assist Relationships (Part 1 of 4) 
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Part 1 
I B | 
II 



A virtual machine 
operator logs on 



II 



Hardware assist status: 

CP assist off, 

virtual machine assist 

on, 

expanded virtual machine 

assist off, 

virtual interval timer 

assist on 



r 1 

I C | 
i i 



II 



virtual machine operator 

may issue the following 

commands: 

SET ASSIST OFF 

SET ASSIST NOTMR 

SET ASSIST OFF NOTMR 



ii 



Virtual machine operator 
issues SET ASSIST OFF 



I I 



Virtual machine operator 
issues SET ASSIST NOTMR 



Virtual machine operator 
issues SET ASSIST OFF 
NOTMR 



II 



Sacnlfe 1 



| 

exp. virt. mach. assist I 

off, j 

virt. mach. assist off, j 

virtual interval timer | 

assist off | 



i 1 

I E | 
i i 





Result 


s: 


I virt. 


mach. 


assist 


1 on. 






1 exp. 


virt. 


machine 


I assist off. 




I virt. 


intvl 


. timer 


I assist off 





i Virtual machine | 
| operator issues j 
I SET ASSIST TMR | 



i 1 

I C | 
t i 

Part 2 



r~ '■" '- 








Results : 


| virt. 


mach. 


assist 


1 off. 






1 exp. 


virt. 


machine 


I assist off. 




I virt. 


intvl 


timer 


I assist off 





I 1 

I 

I 1 



Virtual machine | 
operator issues ! 
SET ASSIST ON TMR to' 
turn virt. machine 
assist on, expanded 
virt. mach. assist 
off, virt. interval 
timer assist on 
r 



i — ■ — i 
I C | 
t 1 

Part 2 



I Virtual machine | 
! operator issues | 
I SET ASSIST ON TMR | 
i . 1 



I C j 
i— 1 

Part 2 



I Virtual machine I 
] operator issues | 
I SET ASSIST ON | 

i . i 



I E | 
I i 

Part 2 



Figure 27. Hardware Assist Relationships (Part 2 of 4) 
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I 1 

I a virtual machine | 
| operator logs on J 
I—- j 



Virtual machine extended 

control status is: 

CP assist on, 

virt. mach. assist off, 

expanded virtual machine 

assist off, 

virtual interval timer 

assist off 



II 



Because no VM/370 ECPS 
functions are on, an 
error message is dis- 
played if the virtual 
machine operator issues 
SET ASSIST THR or SET 
ASSIST ON 



I The system operator must issue 
I SET SASSIST OH and SET CPASSIST OH 
I to enable all the VM/370 ECPS 
I functions 
i 



Figure 27. Hardware Assist Relationships (Part 3 of U) 
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Part 1 
I F | 

II 

i 1 

| A virtual machine | 
| operator logs on | 

L ,. J 

|| 



I Virtual machine ECPS | 

I status is: I 

I exp. virt. mach. assist I 

I on, I 

| virt. mach. assist on, I 

| virtual interval timer | 

I assist on I 

i 1 



| Virtual machine operator | 

I may issue the following j 

I commands: I 

| SET ASSIST OFF | 

| SET ASSIST NOTMR | 

| SET ASSIST OFF NOTMR | 



I I 



I Virtual machine operator |- 
| issues SET ASSIST OFF | 
a 1 

II 

i 1 

I Virtual machine operator |- 
| issues SET ASSIST NOTMR | 

i 1 

II 



Virtual machine operator | 
issues SET ASSIST OFF | 
NOTMR | 

___ , 1 



I I 



Results: 



exp. virt. mach. assist 

off, 

virt. machine assist off, 

virt. intvl. timer assist 

off 



I G | 

L J 



I 
I 1 

I Virtual machine | 
I operator issues I 
I SET ASSIST ON I 

t ... . , , , i 

I 



i 1 

I H | 
i i 



Results: 



exp. virt. mach. 

assist on, 

virt. mach. assist 

on, 

virt. intvl. timer 

assist off 



I Virtual machine I 
| operator issues SET I 
I ASSIST TMR I 

i 1 

I 



I G | 
a 1 

Part 4 



I 



Virtual machine j 
operator issues | 
SET ASSIST ON TMR | 



I H | 
i 1 

Part 4 



I ! 

I G | 
t J 

Part 4 



Results: 



exp. virt. mach. 
assist off, 
virtual machine 
assist off, 
virtual interval 
timer assist off 



I Virtual machine | 
| operator issues | 
| SET ASSIST ON TMR| 

i 1 



I G | 
Part 4 



Figure 27. Hardware Assist Relationships (Part 4 of 4) 
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CONTROL PROGRAM ASSIST (CP ASSIST) 



The following information describes the CP assist functions 
invoked directly or indirectly by the VM/370 Control Program. 



that are 



CP assist is part of ECPS. CP assist is hardware that assists VM/370 
Control Program functions with new instructions. 



Instruction Format of CP Assist Instructions 



Except for the functions initiated by VM/370 SVCs, all CP assist 
functions are System/370 instructions. The CP assist instructions are 
six bytes long and are in an SS format. The format is: 







16 



20 



E6 



XX 



I B1 | 

-J L. 



D1 



32 

T* 



B2 



36 

T 



D2 



where: 

E6 is the first byte of the op code for all CP assist instructions 

xx is the second byte of the op code and is an cp code extension 
that is unique for each instruction. 

Each instruction has two operands that are effective addresses 
calculated from the B1D1 and B2D2 values in the normal System/370 way. 
The specific CP assist instruction determines whether these operands are 
data, addresses, or not used. 



Instruction Summary for Control Program Assist 



The following table summarizes the operation codes, 
and descriptions of the CP assist instructions: 



instruction names. 



Trace Table 
Q£ Code Entry 



E600 
E601 
E602 
E603 
E604 
E605 
E606 
E607 

E608 
E609 
E60A 
E60B 
E60C 
E60D 
E60E 
E60F 
E610 



Yes 

Yes 

No 

No 

No 

No 

No 

No 

No 
NO 
NO 
No 
No 
No 
No 
No 
No 



VM/370 CP 
Instruction Function 

FREE Get free storage space 

FRET Return free storage space 

PTRLK Lock a page 

PTROL Unlock a page 

DECCHO Decode subsequent CCW commands 

ONTFR Free CCW storage 

SCNVU Locate virtual I/O control blocks 

DSP1 Dispatch a block or a virtual 

machine - full function 

TRANBRNG Test page status 

TRANLOCK Test page status and lock 

ZAPSEGS Invalidate segment table 

ZAPPAGE Invalidate page table 

DECCW1 Decode first CCW command 

DSPO Main entry to dispatcher 

SCNRO Locate real I/O control blocks 

CCWGENRL Common CCW command processing 

ONTRN Ontranslate CSW 
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Trace Table 
QP_ Code Entrj 



E611 

E612 
E613 
0A08 
OAOC 



Yes 

No 
No 
Yes 
Yes 



VH/370 CP 
Instruction Function 

DSP2 Dispatch a block or a virtual 

machine - abbreviated function 
STECPSVM Store VH/370 ECPS identification 
SHARED Locate changed shared page 
LINK VM/370 Control Program SVC LINK 
RETURN VM/370 Control Program SVC RETURN 



Locating CP Assist Instructions in Assembly Listings 

The following example shows how to identify CP assist instructions in 
assembly listings. 



E600F718F64B 



USING DMKFREE, R15 
DMKFREE DS 
DS 
DC X'E600«,S(SUBTABLE,BYTBL-1) 

STM R0,R15,FREESAVE 

LR R12,R15 



3V386918 00218700 

9V386198 00218800 

9V386198 00219200 

***V386198 00219300 

..%V386198 00220000 

XV386198 00221000 



CP assist instruction is 
identified by E6 op code 



CP assist function exe- 
cutes software instruc- 
tions identified by (%) 
sign. 



Note; Instructions marked with % in column 64 may not actually be executed 
if CP assist is enabled. For example, register contents may not be stored 
in temporary save areas and certain additional constants may be referenced. 
However, the functional equivalent of the group of instructions marked by 
the % is performed by CP assist. 



LSSliiBa XlJiJl Instructions UsijKj DMKCPI and a Lead Map 

DMKCPI ENTRY POINT LIST: In the module DMKCPI is a list of entry points 
that contain the control program assist instructions (X'Ee* op code) . 
This list has the label CPATABLE. This list is shown in the following 
example: 





Entry 


CP Assist 


Label 


Point 


Op Code 


CPATABLE DS 


OF 




DC 


V (DMKFREE) 


E600 


DC 


V (DMKFRET) 


E601 


DC 


V(DMKPTRLK) 


E602 


DC 


V(DMKPTRUL) 


E603 


DC 


V (DMKCCH0) 


E604 


DC 


V(DMKUNTFR) 


E605 


DC 


V(DMKSCNVU) 


E606 


DC 


V(DMKDSP1) 


E607 


DC 


V(DMKCCWB1) 


E608 


DC 


V(DMKCCHB2) 


E608 


DC 


V(DMKCCWB3) 


E608 


Append. 
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Label 





Entry 


CP Assist 




Point 


02 Code 


DC 


7 (DHKCCWB4) 


E608 


DC 


7(DMKCCWB5) 


E608 


DC 


7(DHKCCWB6) 


E608 


DC 


V (DMKCCWB7) 


E608 


DC 


V (DMKCCWB8) 


E608 


DC 


7(DMKCCWL1) 


E609 


DC 


7(DMKCCWL2) 


E609 


DC 


V (DMKCCWL3) 


E609 


DC 


V (DMKCCWL4) 


E609 


DC 


7(DMKCCWL5) 


E609 


DC 


7(DMK7ATZS) 


E60A 


DC 


V(DHKVATZP) 


E60B 


DC 


V(DMKCCW1) 


E60C 


DC 


V(DMKDSPO) 


E60D 


DC 


V (DMKSCNRO) 


E60E 


DC 


7 (DHKCCWGN) 


E60F 


DC 


7 (DMKUNTRN) 


E610 


DC 


7(DMKDSP2) 


E611 



LOAD LIST FOR ENTRY POINT LOCATIONS; The following is an example of the 
load list for module DMKFRE that contains the entry points DHKFREE and 
DMKFRET. If you consult the DMKCPI entry point list above, you will 
find that entry points DMKFREE and DMKFRET contain the CP assist 
operation codes X , E600» and X»E601'. 



:READ DMKFRE TEXT 



in 





DMKFRE 


AT 


01A740 


. . . 


.DMKFREE 


AT 


01A740 


. . 


.DMKFRET 


AT 


01AB38 


. 


DMKFRETR 


AT 


01AB26 


. 


DMKFRELG 


AT 


01AF20 


. . 


DMKFRELS 


AT 


01AE48 




DMKFRELO 


AT 


01AE54 




DMKFREHI 


AT 


01AD88 




DMKFRENP 


AT 


01AE8C 




DMKFRES7 


AT 


01AE9C 




DMKFREST 


AT 


01AE58 




DMKFRETL 


AT 


01AD80 




DMKFRERS 


AT 


01AAC8 



xx xx-xxx 5/14/76 11:15 
***************************************** 

* * 

* This area contains a list of updates * 

* and macro libraries included in the * 

* assembly. * 

* * 
***************************************** 



1| This is the module DMKFRE loaded at 
address 01A740. 



|2| This is the entry point DMKFREE loaded 
« — * at address 01A740. The entry point 
list in DMKCPI shows that this entry 
point contains an X'EeOO 1 op code. 



3 | This is the entry point DMKFRET loaded 
— « at address 01AB38. The entry point 
list in DMKCPI shows that this entry 
point contains an X^eOI' op code. 



Turning Off Selected Hardware Assisted Functions 



The following information describes how to turn off selected ECPS 
functions if you suspect a problem with the function. 

In some cases, hardware-assisted functions are invoked by other 
hardware-assisted functions and they must all be made NOOPs to 
completely disable the function. To find all the functions that are 
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related and that must all be turned off to disable the function, see the 
following instruction cross-reference list. 

Those hardware-assisted functions that are not in the list nay be 
turned off individually without being concerned about other functions 
that may call it. 

The SVC8 and S7C12 functions of CP assist can be disabled by setting 
certain input parameters in the VMALIST to extreme values. The various 
functions provided by expanded virtual machine assist are controlled by 
the setting of bits in the MICBLOK's assist control field, see the topic 
"Expanded Virtual Machine Assist" for details. 



Instruction/Function Cross-Reference List 

Function lM2<>te§. By, 

DECCI1 DECCWO 

DSP2 DSP1 

FRET DNTFR, DSP2 

PTRLK CCWGENRL, TRANLOCK 

PTRDL DNTFR 

RETDRN CCWGENRL, DNTFR 

SHARED DSP2 

TRANBRNG DECCH1 

ZAPPAGE ZAPSEGS 

ZAPSEGS DSP2, PTLB 

Hote; Be careful when making these functions NOOPs. For example, to 
completely turn off ZAPPAGE, ZAPPAGE and ZAPSEGS must be made NOOPs. 
But ZAPSEGS is invoked by DSP2 and PTLB. Therefore, DSP2 and PTLB must 
both be made NOOPs. DSP2 is invoked by DSP1; therefore, DSP1 must also 
be made a NOOP. The end result must be that DSP1, DSP2, PTLB, ZAPZEGS 
and ZAPPAGE must all be turned off. 

I Note; DSPO, DSP1 and DSP2 CP ASSIST instructions are changed to NO-OP 
I instructions in System Extensions Program Product, Program No. 5748- XE1. 



Using, the Instruction/Function Cross-Reference List To Defeat Function s 

As an example, assume that you want to defeat the FRET hardware-assisted 
function. 

1,. Look up FRET in the Instruction/Function Cross Reference List. 

FRET is invoked by UNTFR and DSP2. DSP2 is invoked by DSP1. 

Therefore, the four functions that must be deleted are: FRET, 
DNTFR, DSP2, and DSP1. 

2. FRET is part of DMKFRE, DNTFR is part of DMKONT, DSP2 and DSP1 
are part of DMKDSP. These are the modules that contain the 
hardware assisted code that must be made NOOPs. 

3. Listed in the CPATABLE list of DMKCPI are the following entry 
points: 

DMKFRET which contains the CP assist instruction E601 
DMKDNTFR which contains the CP assist instruction E605 
DHKDSP1 which contains the CP assist instruction E607 
DMKDSP2 which contains the CP assist instruction E611 
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The load nap for your VM/370 system 
entry points, and their locations- 



lists the modules and 



Osing the DMKCPI list to find the CP assist op code and entry 
point name, and the load list to find the location of that 
entry point, replace the CP assist instructions (X*E6xxxxxxxxxx*) 
in those locations with three NOOPs (X» 470000000700») . 



Exceptions to Control Program Assist 



All CP assist instructions cause operation exceptions if ECPS is not 
installed. The CP assist instructions are executed as NOOPs if the PSW 
is in supervisor state and VM/370 ECPS is installed but the CP assist is 
disabled in control register 6. If VM/370 ECPS is installed but the PSW 
is in a problem state, the CP assist instructions cause privileged 
operation exceptions regardless of the setting of control register 6 bit 
6. 



EXPANDED VIRTUAL MACHINE ASSIST 



Expanded virtual machine assist is part of the VM/370 Extended 
Control-Program Support. Expanded virtual machine assist is hardware 
that executes certain privileged operations issued by a VM/370 virtual 
machine. Expanded virtual machine assist is an extension of the Virtual 
Machine Assist feature. Expanded virtual machine assist is invoked only 
if virtual machine assist cannot execute the subject instruction in the 
virtual machine, a corresponding virtual machine assist function is 
defined, and that virtual machine assist function would present a 
privileged operation exception. In some cases, expanded virtual machine 
assist does not completely execute the subject instruction. 



In str uction Summary for Expanded Virtual Machine Assist 

The following table summarizes the operation codes, instruction names, 
amount of execution of the instruction by expanded virtual machine 
assist, and descriptions of the instructions: 









Amount of 




Trace 




Execution 




Table 




of VM/370 


Op Code 


Jntry 


Instruction 


Function 


82 


Yes 


LPSW 


Partial 


B20D 


No 


PTLB 


Complete 


E206 


Yes 


SCKC 


Partial 


9C 


Yes 


SIO,SIOF 


Partial 


B208 


Yes 


SPT 


Partial 


80 


Yes 


SSM 


Partial 


AC 


Yes 


STNSM 


Partial 


AD 


Yes 


STOSM 


Partial 


B209 


No 


STPT 


Complete 


9F 


No 


TCH 


Complete 



Virtual Machine 
Definition 

Load PSW 

Purge Table Lookaside Buffer 

Set Clock Comparator 

Start I/O, Start I/O Fast 

Set CPU Timer 

Set System Mask 

Store Then AND System Mask 

Store Then OR System Mask 

Store CPU Timer 

Test Channel 
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Enabling and Disabling Expanded Virtual Machine Insist Functions 

although all of the functions provided by expanded virtual machine 
assist can be disabled by values in control register 6, any of the 
functions of expanded virtual machine assist can be enabled or disabled 
by the setting of bits in a field defined in the MICBLOK (displacement 
X'14', label MICEVMA) in conjunction with values in control register 6 
that enable expanded virtual machine assist. Specifically, if bits 
and 6 of control register 6 are both on and the real machine is in 
virtual supervisor state, then the finer controls provided in the 
specified MICBLOK field are active. If those two bits in control 
register 6 are not both on, or if the real machine is not in virtual 
supervisor state, then the settings of the MICBLOK assist controls are 
ignored. 

During virtual supervisor state execution, a particular function of 
expanded virtual machine assist is enabled only if: 

• Expanded virtual machine assist is enabled in control register 6 
(bits and 6 are both on) , and 

• The bit defined for that function in the MICBLOK assist control field 
is on. 

Virtual machine assist is unaffected by the MICBLOK assist control 
field. 

Some bits in the MICBLOK assist control field enable and disable 
several functions of expanded virtual machine assist. This is because 
of the similarity in the definitions of the controlled functions. The 
following table contains the bit definitions of the MICBLOK assist 
control field. 

lii Functions 

Load PSW 

1 Purge TLB 

2 Set clock comparator, set CPD timer 

3 Start I/O 

4 Set system mask, store then AND system mask, 
store then OR system mask 

5 Store CPD timer 

6 Test channel 

These MICBLOK assist control bits can also be used to enable or 
disable all of expanded virtual machine assist. If bits and 6 of 
control register 6 are both on, and the assist control bits are off, 
then CP assist is enabled but expanded virtual machine assist is 
disabled. 



VIRTUAL INTERVAL TIMER ASSIST 

Virtual interval timer assist is the hardware support for an interval 
timer in the virtual machine. The virtual machine may be in either EC 
mode or BC mode. The virtual interval timer is in the virtual machine's 
page frame and functions like the real interval timer. 

The virtual interval timer runs without either the CP assist or the 
extended virtual machine assist being active. The virtual interval 
timer assist is only active if virtual machine assist is active. Bits 
and 7 of control register 6 control the virtual interval timer assist. 
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Virtual Interval Timer Main tenance 

Eit 23 of the virtual interval tiier is decremented like the real 
interval tiner. If a virtual machine is executing (the real PSW is in 
problem state) and the real interval timer needs updating, both the real 
interval timer and the virtual interval timer are updated. The virtual 
interval timer is decremented only if the following conditions are true: 

• The real PSW is in the problem state (bit 15 = 1) 

• Virtual machine assist is enabled (control register 6 bit 0=1) 

• Virtual interval timer assist is enabled (control register 6 bit 7 = 
1) 



Virtual Interval Timer Assist Interrupt 

A virtual interval timer interrupt request is recognized when the 
virtual interval timer is decremented from a positive value, including 
zero, to a negative value. When this condition occurs, an interval 
timer interrupt is presented to the virtual machine. 

If the virtual interval timer interrupt cannot be presented to the 
virtual machine, the virtual interval timer interrupt is presented to 
the real machine. When presented to the real machine, the virtual 
interval timer interrupt is distinguished from the real interval timer 
interrupt by a unigue external interrupt code (bit 7 of the halfword 
interrupt code set to 1 and bits 0-6 set to 0) . Bits 8-15 of the 
interrupt code are zero unless set to one for another condition that may 
be concurrently indicated. (Locations X'84' and X'85' are set to zero.) 
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Appendix B: VM/370 MSS Support 



VM/370 MSS Support 



Following are annotated flow diagrams for the logic to support the IBH 
3850 Mass Storage System. 



| LOGON A USER HAVING A MINIDISK ON AN UNMOUNTED SYSTEM VOLUME 

DMKLNK, CJK3330V 

A required system volume is not mounted, try to get a 3330? mounted 
if the minidisk is a 3330. 

DMKSSSLN 

Entry to mount an MSS system volume. 

DMKSSS, FINDRDEV 

Allocate a SYSVIRT real 3330V device. This may involve demounting a 
volume which is mounted but not in use. If there are none such 
volumes available, issue message DMKSSS080E and return with return 
code 8. 

DMKSSS, BLDCOMMT 

Construct an MSSCOM, filling in the volume serial, device address 
selected, type of request (mount), and userid. 

DMKSSS, SETMNTFG 

Build a CPEXBLOK for the return to DMKLNK after the MSC has processed 
the request. Chain it from field MSSTASK2. Build a CPEXBLOK for the 
return to DMKLNK after the mount is complete (pack change 
interruption received on the 3330V). Chain it from field MSSTASK1. 

DMKSSS, SCHMSSC 

Put the MSSCOM in the queue, generate an attention interruption for 
the communication device if necessary, and exit to DMKDSP. 

DMKSSS, HVC04ENT 

Entry when DIAGNOSE code X'18' f subcode 4 is received. OS/VS is 
ready to process an MSC request. Place the next MSSCOM in the 
virtual machine, and return to DMKHVC. 

DMKSSS. HVC08ENT 

Entry from ~*DMKHVC when DIAGNOSE code X'78 1 , subcode 8 is received. 
The MSC has processed the mount request. 

DMKSSS, RESET MO. R 

If there was an MSS error, write message DMKSSS083E and return to 
DMKLNK with return code 8. 

DMKSSS, MNTCOM 

If there was not an MSS error, indicate that the MSSCOM is now 
waiting for the pack change interruption. Write message DMKSSS088I. 
Return to DMKLINK with return code 4. 

DMKLNK, MNTSETUP 

Return from DMKSSS. Save the current workarea and control 
information. Return to caller. 
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I DMKDSB 

I ~ Entry from DMKDAS on pack change interruption. If the device is a 
| 3330V, look for an MSSCOM waiting for this volume serial. If one is 
| found, stack a CPFXBLOK for entry to DMKSSSEN. Exit to DMKDSP. 

| DMKSSSEN 

| Pick up the CPEXBLOK for DMKLNKSS and stack it. 

I DMKLNKSS 

| Complete the LINK processing for the minidisk. 



I LOGON A USER HAVING A 3330V DEDICATED AS A 3330V 

| DMKLOG, CALLMSSA 

I Determine that a virtual 3330V is needed, save the ODEVBLOK, call 

| DMKSSSL1. 

I DHKSSSL1 

| Go through device allocation, etc., to schedule a mount. 

I DMKLOG, MSSMOONT 

I If an MSS mount is in process (return code 4 from DMKSSS) , proceed to 
I get the next directory statement. Otherwise, find the RDEVBLOK for 
I the device that DMKSSS allocated and continue the dedicat process. 

I DMKLOGSS 

I Entry from DMKDSB and DMKSSSEN after mount. 

| DMKSCNRO 

I ~ Get the RDEVBLOK 

I PMKVDSAT 

I Attach the virtual device. 

I DMKLOG, TSTV333V 

I ~ If the virtual device is a 3330V, set flag RDEV333V to indicate that 

I there is no CP MSS CCW prefix. 

I DMKLOG, FREED DEV 

I If there is virtual I/O waiting, as indicated by a CPEXBLOK address 
I in field MSSTASK3 of the MSSCOM used for the mount, stack the IOBLOK. 
I Return to DMKDSP. 



| PROCESS DIAGNOSE CODE X'78 1 

i DMKSSS HV 

I Entry from DMKHVC when DIAGNOSE code is X'18 1 . 

| DMKSSS, HVC00ENT 

I The entry subcode was 0. Save the communication device address and 
j the communicator VMBLOK address. Set PSAMSS indicating that the MSC 
I is now available. 

| DMKSSS, HJC04ENT 

I The entry subcode was 4. If there is an MSSCOM in the queue to be 
I processed, call DMKPTRAN to get the communicator's buffer address. 
( Put the MSSCOM in the virtual machine buffer. 
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DMKSSS, HVC08ENT 

The entry subcode was 8. The MSC has processed a request. If there 
was an error, write message DMKSSS088E, dequeue the MSSCOM, stack the 
return to the DMKSSS caller from MSSTASK2 with a return code 8, and 
return to DMKHVC. If there was no MSC error, stack the HSSTASK2 
CPEXBLOK with a return code of 4, and return to DMKHVC. 



| GENERATE THE CHANNEL PROGRAM PREFIX FOR A 3330V 

I DHKCCW 

| Entry to generate a real channel program from a virtual machine 

j channel program. 

CCglNDSD 
If the real device is a 3330V, set a flag indicating that the MSS 

I channel program prefix is needed. 

| DHKCCW, CCW 02 

I If the prefix-needed flag is on and the virtual device is not a 

I virtual 3330V, put the prefix in the RCWTASK. 

I PPCCW, DASDTBL AND DEDDTBL 

| These are tables of addresses of routines that are to get control to 

| process specific CCH operation codes for DASD and dedicated devices. 

I In each subroutine, a check is made to see if there is an unresolved 

j HSS prefix. If so, it checks to see if the virtual channel program 

I contains a SEEK. If so, it checks to see if the argument is used to 

| generate the SEEK argument for the prefix. If not, the prefix CCW is 

I set to SEEK to cylinder 0. 



| GENERATE THE CHANNEL PROGRAM PREFIX FOR CMS I/O TO A 3330V 

I DHKDGD 

I Entry to process I/O requests to DASD as initiated by the special 

i DIAGNOSE code *78» interface from CMS. 

I DMKDGp, NOP RE 

I If the real device is a 3330V, set up the prefix in the RCWTASK. 

I DMKDGD, CJK MOUNT 

I The VDEVBLOK for the virtual device could not be found. Check to see 
I if there is an MSS mount in process for the required system volume. 
I If so, build a CPEVBLOK for this request, put the address in the 
I MSSTASK3 field of the MSSCOM, and exit to DMKDSP. 



I PROCESS A STAGING ADAPTER CYLINDER FAULT 

I DMKIOSIN 

I Entry when ending status is received from a device. Check to see if 

I the CSW contains CE-DE with no error status. 

I DHKIOS. TESTCYL 

I If the device type is a 3330V, see if the CE-DE is in the HSS prefix 
I NOP CCW. If not, or if the device is dedicated as a virtual 3330V, 
I stack the IOBLOK. 
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I DMKSSS12 

I ~ Set the IOBFLT flag, indicating that a cylinder fault is being 

| resolved. Chain the IOBLOK from the REDEVFIOE field in the RDEVBLOK. 

| Build a TRQBLOK to recognize missing attention interruptions and put 

I it on the timer queue. Exit to the dispatcher. 



| PROCESS AN ATTENTION INTERRUPT FROM A 3330V 

I DMKIOS, IOSUNSOL 

| Entry to process unsolicited I/O interrupts. 

I CMKIOS. CALLMSSA 

i If the interrupt is an attention, the device is a 3330V, and it is 

I not dedicated as a 3330V. Call DHKSSSI1 to restart I/O. 

I DMKSSSrl 

I Find each IOBLOK for this device that has the IOBFLT flag set. Find 
I the associated timer queue element and remove it from the timer 
| queue. Turn off IOBFLT so that the IOBLOK can be restarted when the 
j device is available. 
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Index 



A 

abend (see abnormal termination (abend)) 

abnormal termination (abend) , CP, codes 

1-406 
accounting card, generating 1-63 
accounting records, processing 1-144 
address, translation, virtual-to-real 1-24 
affinity, in attached processor mode 1-34 
allocation 

cylinder 1-112 
management 1-105 
of BASD space 1-139,1-205 
of storage 1-203 
page frame, free storage 1-122 
slot 1-111 
alternate path I/O 1-92 
alternate track 

control flow 1-168 
hardware operations 1-167 
module function 1-168 
recovery 

CP I/O 1-169 
Diagnose I/O 1-169 
ERP 1-166 
3340 support 1-166 
assigning, dedicated channels to virtual 

machine 1-7 
assignments, RMS Control Register 1-152 
attached processor 1-172 

external interrupts 1-178 
initialization 1-172 

PSA set-up 1-172 
I/O subsystem 1-179 
locking 1-173 

global system lock 1-173 
user-defined locks 1-174 
VMBLOK lock 1-173 
machine check handler 1-174 
shared segment 1-180 
varying offline 1-73 
attaching 

real devices 1-125 
virtual devices 1-6 
virtual machine to the system 
1-123,1-211 
attributes, spool file 1-145 



B 

binary synchronous line 

data formats 1-103 

enabling/disabling, remote 3270 1-201 

error recovery, 3270 1-202 

I/O programs for 1-99 



C 
calling 

DMKFREE 

for a large block 1-121 
for a subpool 1-121 
DHKFRET 

for a large block 1-122 
for a subpool 1-121 
CCH (channel check handler) 1-149 
overview 1-157 
subroutines 

channel control 1-158 
channel error analysis 1-159 
changes, user status 1-132 
channel, dedicated, support 1-96 
channel check handler ( see CCH (channel 

check handler) ) 
channel check interrupt, processing of 

1-222 
channel errors, DASD 1-164 
channel program, modification 1-60 
channel-to-channel adapter, virtual 1-86 
checkpoint, spool file, recovery of closed 

1-225 
class, privilege 1-9 
clearing, recording area 1-163 
clock interrupt reflection 1-184 
closed, checkpointed spool files, recovery 

of 1-225 
closing 

virtual machine input files 1-217 
virtual output files 1-216 
cold start 1-14 
commands (see CP commands) 
communication, inter-virtual machine 1-225 
component states, I/O 1-89 
console 

functions (see CP (Control Program) , 

console functions) 
scheduling 1-198 
simulation, virtual 1-192 
COHTASK data, processing of 1-197 
COHTASK interrupt, control, processing of 

1-198 
control block, I/O, real 1-83 
control block relationships, VHCF 1-43 
Control Program ( see CP (Control Program) ) 
control program assist 1-37,1-409,1-416 
described 1-416 
exceptions to 1-420 
instruction format 1-416 
instruction/function cross-reference 
list 1-419 

using to turn off functions 1-419 



Index 1-427 



instructions 1-417 

finding with DMKCPI and load map 
1-417 

load list for entry point locations 
1-418 

locating in assembly listings 1-417 

summary of> 1-416 
control register 
usage 1-79 
used by MCH 1-152 
control register 6 

bit definition 1-409 
control for ECPS 1-409 
conventions, pageable CP nodules 1-80 
CP (Control Program) 
abend codes 1-406 

annotated flow diagram, use of 1-183 
attached processor 1-172 
command module entry points 1-403 
commands (see CP commands) 
concurrent execution of virtual machines 

1-3 
console functions 1-127 

processing 1-213 
HIO operations 1-196 
initialization 1-14,1-123 

procedures 1-208 
interrupts 

handling 1-46 

processing 1-183 
I/O management on virtual machine 1-6 
I/O operations, scheduling of 1-195 
I/O scheduling for CP and the virtual 

machine 1-190 
label-to-module cross-reference 1-300 
module entry point directory 1-229 
module- to- label cross-reference 1-257 
page zero handling 1-5 
privileged instruction simulation 1-3 
problem state execution 1-3 
program organization 1-183 
real control blocks, I/O 1-15 
request stack 1-136 
SIO operations 1-195 
spooling 1-7,1-136,1-216 
SVC interrupt handling 1-17 
termination 1-123 

procedures 1-208 
virtual 

interrupt processing 1-189 

I/O operations 1-189 
virtual control blocks, I/O 1-16 
virtual machine interrupt handling 1-3 
wait state, codes 1-403 
CP assist (see control program assist) 
CP commands 1-9 

CP processing 1-213 
spool files 1-144 

management 1-147 
spooling 

real 1-146 

virtual 1-146 



CP diagnostic aids 1-401 
cross-reference 

label-to-module, CP 1-300 
module-to-label, CP 1-257 
CTCA operations between virtual machines 
1-189 



DASD (Direct Access Storage Device) 
error recovery 1-163 
errors, during spooling 1-148 
I/O initiated via DIAGNOSE 1-190 
space 

allocation of 1-139,1-205 
de-allocation of 1-205 
exhausted for spool files 1-149 
storage management 1-111 

cylinder allocation 1-112 
slot allocation 1-111 
DASD I/O function 1-56 
data area modules 1-80 
data format 

for binary synchronous lines 1-103 
for remote 3270 1-103 
read header message 1-104 
read text message 1-104 
write text data message 1-103 
write text message for the copy command 
1-103 
de-allocation of DASD space 1-205 
dedicated channel 

assigning to virtual machine 1-7 
support 1-96 
defining, a virtual device 1-125 
demand paging 1-5 

detaching, virtual devices 1-6,1-126 
devices 
real 

attaching 1-125 
spooling commands 1-146 
virtual 

defining 1-125 
detaching 1-126 
spooling commands 1-146 
DIAGUOSE instruction 1-49 

channel program modification 1-60 
clear error recording cylinders 1-57 
DASD I/O function 1-56 
define function of PA2 function key 

1-65 
determine virtual machine storage size 

1-67 
device type function 1-58 
directory update-in-place 1-72 
display data on 3270 console screen 

1-65 
error message editing 1-66 
examine real storage 1-51 
FIHDSYS function 1-69 
function codes for 1-407 
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general I/O function 1-58 

generate accounting cards 1-63 

input spool file manipulation 1-53 

load 3800 named system 1-70 

LOADSYS function 1-67 

MSS support 1-71 

page release function 1-53 

pseudo timer 1-53 

PORGESYS function 1-68 

read LOGREC data 1-62 

read system dump spool file 1-62 

read system symbol table 1-63 

save 3704/3705 control program 1-65 

start of LOGREC area 1-62 

starting a general I/O operation 1-191 

store extended-identification code 1-50 

update VM/370 directory 1-63 

used to start standard DASD I/O 1-190 

virtual console function 1-51 

VMCF function 1-69 

3270 virtual console interface 1-65 
diagnostic aids, CP 1-401 
direct access storage device (see DASD 

(Direct Access Storage Device) ) 
directory (see Virtual Machine 

Facility/370"7vB/370) , directory) 
directory update-in-place, DIAGNOSE 

instruction 1-72 
disable a line, I/O program 1-100 
disconnecting 

terminal 1-126 

virtual machine 1-126 
discontiguous saved segments 

loading 1-67 

purging 1-68 
dispatch entry, MAIN 1-2 14 
dispatch entry point 1-214 
dispatched user, reflection for 1-214 
dispatching 1-214 

algorithm 1-133 

enabling for interruptions 1-134 

fast redispatch 1-134 

interactive users 1-11 

noninteractive users 1-11 

priority, calculating 1-11 

scheme, for virtual machines 1-11 

states, user 1-130 

support routines 1-136 

virtual machine 1-215 

virtual machines 1-128 
examples 1-130 
from queue 1 1-11 
from queue 2 1-11 

working set 1-133 
dispatching lists, virtual machine 1-128 
displaying, data on 3270 console screen 

1-65 
DMKCKP 1-14 



DHKCPI 1-14 

DMKEXTSL 1-178 

DHKFREE 

calling for a large block 1-121 
calling for a subpool 1-121 

DMKERET 

calling for a large block 1-122 
calling for a subpool 1-121 

DMKISMTR, handling, OS ISAM 1-87 

DHKPRV 1-118 

DMKSAV 1-14 

DHKVAT 1-118 

DMKVIO 1-95 

dump the system 1-210 



E 
ECC 

recording modes 1-156 

validity checking 1-152 
ECPS (Extended Control-Program Support) 
1-37,1-409 

control by control register 6 and 
MICBLOK assist control field 1-409 

CP assist 1-37 

expanded virtual machine assist 1-37 

interaction with DOS emulator 1-409 

interaction with other functions 1-409 

interaction with program event recording 
(PER) 1-409 

interaction with VMA 1-409 

interaction with VS1 assist 1-409 

restricted use 1-38 

summary of control 1-409 

trace table entries 1-411 

virtual interval times, assist 1-38 
editing, error messages 1-66 
efficiency, of VH/370 performance options 

1-25 
enable a line, I/O program 1-100 
enabling for interruptions 1-134 
enhancements, miscellaneous, with 7K/YS 

Handshaking feature 1-45 
entry points for CP commands 
ERP (error recording program) 
error messages, editing 1-66 
error recording 1-162 

base, establishing 1-220 

cylinders, clearing 1-57 

record writing 1-162 

via SVC 76 1-161,1-222 
error recovery 1-162 

DASD 1-163 

hard 1-117 

soft 1-117 

spool files 1-148 

tape 1-165 

virtual storage paging 1-116 

3270 binary synchronous line 1-202 

3270 remote 1-171 



1-229,1-403 
1-159 



Index 1-429 



errors, DASD, during spooling 1-118 
examples, of virtual machine dispatching 

and scheduling 1-130 
executable modules 

pageable 1-81 

resident 1-80 
executing, the pageable control program 

1-78 
execution 

favored 1-135 

of scheduled users 1-215 
expanded virtual machine assist 1-37,1-409 

defined 1-420 

enabling and disabling of 1-421 

instruction summary of 1-420 
Extended Control-Program Support (ECPS) 

(see ECPS) 
extended virtual external interrupt 1-76 
extended-identification code 1-50 
external interrupt 1-76 

external console interrupt 1-18 

interval timer 1-18 

multi-processor 1-178 

reflection 1-184 

TOD clock comparator 1-18 



failure, system, recovery 1-149 

fast redispatch 1-134 

favored execution option 1-30,1-135 

features 

System/370 recovery 1-151 

control registers used by HCH 1-152 
ECC validity checking 1-152 
processor retry 1-151 

VM/VS Handshaking 1-43 
fetch storage protection 1-78 
first-level storage 1-117 
format 

CCW, 3270 remote 1-98 

spool data 1-137 

spool files 1-137 
formatting, recording area 1-163 
free storage 

management 1-120,1-207 

page frame allocation 1-122 
function codes for DIAGNOSE instructions 
1-407 



graphic I/O processing, local 1-193 



H 

hard error, recovery 1-117 

hardware assist 1-37 # 1-409 

combinations of 1-412 
by SET command 1-412 

control program (CP) assist 1-409 

expanded virtual machine assist 1-409 

functions, turning off 1-418 

relationships 1-412 

summary of control 1-410 

virtual interval timer assist 1-409 
HIO operations, CP 1-196 



initialization 1-14 
CP 1-122 

procedures 1-208 
spool file 1-224 
system 1-122,1-209 

for BBS 1-150 
virtual machine 1-211 
input 

processing 

for a virtual machine 1-217 
real spool files 1-143 
virtual spool files 1-141 
input device, real, spooling to 1-219 
input files, virtual machine, closing of 

1-217 
input/output (see I/O) 
instruction simulation for virtual machine 

1-191 
integrated channels, error analysis 1-159 
interface, error recording, virtual 

machines 1-161 
interrupt 

channel check, processing of 1-222 
external 1-76 

extended virtual 1-76 
handling 1-46 
I/O 1-73,1-90 
handling 1-6 
virtual 1-90 
machine check 1-73 

processing of 1-221 
processing 1-183,1-196 
local graphic 1-193 
HOHITOR 1-185 
program 1-188 
program 1-46 
reflection 

clock 1-184 

external 1-184 

in a virtual machine 1-192 
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secondary, processor for 3270 1-201 
start/stop terminal, processing of 

1-197 
SVC 1-74 
timer 1-76 

3704/3705, handling of 1-199 
interval timer 1-38 

inter-virtual machine communication 1-225 
I/O 

alternate path 1-92 
attached processor 1-179 
component states 1-89 
control blocks 

real 1-15,1-83 

relationship 1-15,1-16 

virtual 1-16 
errors, unit record 1-148 
for DASD 1-190 
function 

DASD 1-56 

general 1-58 
general operation, initiated via 

DIAGNOSE 1-191 
instruction simulation, for virtual 

machine 1-191 
interrupts 1-73,1-90 

virtual 1-^90 
management 1-6,1-83 
overhead in CP, reducing 1-27 
paging 1-113 

privileged instructions 1-46, 1-85 
processing, local graphic 1-193 
program for binary snychronous lines and 

remote 3270s 1-99 
program for binary synchronous lines and 
remote 3270s 

disable a line 1-100 

enable a line 1-99 

read initial 1-102 

read interruption 1-103 

read repeat 1-102 

write continue 1-101 

write ENQ 1-101 

write initial 1-100 

write reset 1-101 
reconfiguration 1-125 
requests 

scheduling 1-91 

virtual 1-84 

virtual selector channel 1-86 
reserve/release 1-94 
scheduler, paging 1-206 
scheduling 1-195 
scheduling for CP and the virtual 

machine 1-190 
supervisor 1-83 
3270, request handler 1-201 



IOB indicators, summary 1-166 
IOBLOK, queuing 1-95 
IPL of the virtual machine 1-211 
ISAM read sequence 

locating 1-194 

validating 1-194 



label-to-module cross-reference, CP 1-300 
loading 

discontiguous saved segments 1-67 

nucleus 1-208 

3800 named system into virtual storage 
1-70 
local graphic 

interrupt processing 1-193 

I/O processing 1-193 
locate ISAH read sequence 1-194 
locked pages option 1-28 
locking 1-173 

global system lock 1-173 

page of free storage 1-203 

user-defined locks 1-174 

VHBLOK lock 1-173 
LOGREC area 

getting starting address 1-62 

reading 1-62 



machine check handler (see HCH (machine 

check handler) ) 
machine check interrupt, processing of 

1-73,1-221 
machine states, virtual machine 1-128 
maintenance, virtual timer 1-81 
management 

allocation 1-105 

commands, for spool files 1-147 

free storage 1-77,1-120,1-207 

I/O 1-83 

of pages 1-203 

real spooling 1-142 

real storage 1-138 

spool buffer 1-138 

storage 

DASD 1-111 
real 1-106 
virtual 1-105 
virtual spooling 1-139 



virtual storage 1-138 
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MCH (Machine check handler) 1-149 
attached processor 1-174 
control registers 1-152 
overview 1-150 
recovery 

functional 1-151 
operator- initiated restart 1-151 
system 1-151 
system repair 1-151 
subroutines 1-152 

buffer error 1-157 
initial analysis 1-153 
main storage analysis 1-154 
operator communication 1-155 
recovery facility mode switching 

1-155 
soft recording 1-156 
storage protect feature (SPF) 

analysis 1-154 
termination 1-157 
virtual user termination 1-155 
uncorrectable errors 1-177 
MICBLOK, assist control field, control of 

ECPS 1-409 
mini IOBLOK 1-93 
minidisks 1-6 
mode, VS1 nonpaging 1-44 
module entry points for CP commands 

1-229,1-403 
modules 

data areas 1-80,1-81 
executable 

pageable 1-81 
resident 1-80 
pageable 

conventions 1-80 
restrictions 1-80 
system support 1-79 
module-to- label cross-reference, CP 1-257 
MONITOR interrupt processing 1-185 
MSS support 1-423 

annotated flow diagram 

generate channel program prefix for 

CMS I/O 1-425 
generate channel program prefix for 

3330V 1-425 
logon user having a 3330V as a 

dedicated 3330V 1-424 
logon user with minidisk on unmounted 

system volume 1-423 
process attention interrupt from a 

3330V 1-426 
process DIAGNOSE code xm 1 1-424 
process staging adapter cylinder 
fault 1-425 
DIAGNOSE instruction 1-71 
multiprogramming, controlling 1-132 



non-I/O, privileged instruction 1-47 
nucleus, loading of 1-208 



obtaining a page of free storage 1-203 
options 

performance 

affinity 1-34 

favored execution 1-30,1-135 

locked pages 1-28 

priority 1-32 

reserved page frames 1-29,1-32 

virtual=real 1-5,1-29,1-32,1-110 

virtual machine 1-30 
order seek queuing 1-95 
OS ISAM, handling by DMKISMTR 1-87 
output 

processing 

real spool files 1-142 

virtual spool files 1-140 
output files, virtual machine, closing of 

1-216 
overhead, CP, reducing for I/O 1-27 



P 
page 

exceptions, effects of 1-27 

faults, pseudo, with VH/VS Handshaking 

feature 1-43 
frames 1-5 

allocation in free storage 1-122 

reserved 1-5,1-29 
management 1-203 
of free storage 

locking 1-203 

obtaining 1-203 

returning 1-203 

unlocking 1-203 
request, processing of 1-203 
selection 1-20 
tables 1-5 

shadow 1-118 

virtual 1-118 
virtual storage 

locking 1-20,1-28 

reading 1-204 

releasing 1-53,1-207 

writing 1-204 
zero, restrictions 1-5 
pageable 

control program, executing 1-78 
CP modules 

conventions 1-80 

restrictions 1-80 
executable modules 1-81 
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paging 1-5 

address translation 1-20 

backing store allocation algorithm 

1-115 
by demand 1-5 
considerations 1-27 
cylinder selection 1-116 
device selection 1-115 
first-level storage 1-117 
I/O 1-113 

I/O request queuing algorithm 1-116 
I/O scheduler 1-206 
lock page 1-20 
page selection 1-20,1-115 
page selection routine support 1-116 
replacement and selection algorithm 

<• -4 4 !■ 
I - I I H 

requests 1-105 
second- level storage 1-117 
shadow tables 1-5 
subsystem 1-114 
third-level storage 1-118 
virtual storage, error recovery 1-116 
password suppression 1-51 
PA2 program function key, defining function 

of 1-65 
performance 1-25 
options 

affinity 1-34 

favored execution 1-30,1-135 
locked pages 1-28 
priority 1-32 

reserved page frames 1-29, 1-32 
virtual=real 1-5,1-29,1-32,1-110 
virtual machine 1-30 
pointer list 

fullwords in 1-411 
MICBLOK 1-411 
virtual machine 1-411 
preferred virtual machine 1-30 
printer, real, spooling to 1-218 
priority of execution, performance option 

1-4,1-32 
privilege classes 1-9 
privileged instruction 
I/O 1-46,1-85 
non-I/O 1-47 
program interrupt 1-46 
simulation 1-3,1-25 
problem state, SVC interrupts 1-183 
processing 

accounting records 1-144 
spool files 

real input 1-143 
real output 1-142 
virtual input 1-141 
virtual output 1-140 
virtual input 1-217 
virtual output 1-216 



processor 

attached, affinity 1-34 

resources 1-11 

retry quiet mode 1-156 

retry recording mode 1-156 

System/370, retry 1-151 

utilization 1-11 
program 

interrupt 1-46 

privileged instruction 1-46 
processing 1-188 

interruption 1-19 

states 1-10 
Program Status Word (see PSW (Program 

Status Word) ) 
programming, remote 3270 1-97 
protection fetch storage 1—78 
pseudo timer 1-53 
PSW (Program Status Word) , validation 

1-214 
punch, real, spooling to 1-218 
purging, discontiguous saved segment 1-68 



Q 

queue 1, dispatching virtual machines from 

1-11 
queue 2, dispatching virtual machines from 

1-11 
queuing 

IOBLOK 1-95 
order seek 1-95 
quiet mode, processor retry 1-156 
Q 1 (see queue 1) 
Q2 (see queue 2) 



read header message, data format 1-104 

read initial- I/O program 1-102 

read interruption, I/O program 1-103 

read repeat, I/O program 1-102 

read text message, data format 1-104 

reading, a DASD page from virtual storage 

1-204 
real 

address 1-24 

device 

attaching 1-125 
spooling commands 1-146 

input device, spooling to 1-219 

spooling 1-22 
real spooling manager (DHKBSP) 1-142 
real storage 

allocation 1-203 

examine 1-51 

management 1-106,1-138 

optimizing use of 1-5 

page management 1-203 

requests for page frames 1-108 
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reconfiguration, I/O 1-125 
record, error, writing 1-162 
recording area 

clearing 1-163 
formatting 1-163 
recording mode 
ECC 1-156 

processor retry 1-156 
recovery 

from system failure 1-149 
MCH 

functional 1-151 
operator-initiated restart 1-151 
system 1-151 
system repair 1-151 
of closed checkpointed spool file 1-225 
System/370 1-151 

control registers used by MCH 1-152 
ECC validity checking 1-152 
processor retry 1-151 
Recovery Management Support (see RMS 

(Recovery Management Support)) 
reduction 

of CP overhead, for virtual machine I/O 

1-27 
of paging activity 1-27 
of SIO operation 1-26 
reenterable code, usage 1-27 
reflection for the dispatched user 1-214 
releasing, virtual storage pages 

1-53,1-207 
relocation, virtual 1-117 
remote 3270 

binary synchronous line 

enabling/disabling 1-201 
error recovery 1-171,1-202 
CCW format 1-98 
data formats 1-103 
I/O programs for 1-99 
programming 1-97 
request handler, 3270 I/O 1-201 
request stack, CP 1-136 
requests 

for real storage page frames 1-108 
I/O 

scheduling 1-91 
virtual 1-84 
paging 1-105 
RESERVE, operand 1-5 
reserved page frames, performance option 

1-5,1-29,1-32 
reserve/release 1-94 
resident, executable modules 1-80 
resources, processor 1-11 
restart, MCH, operator-initiated 1-151 
restrictions, pageable CP modules 1-79 
return a page of free storage 1-203 



RMS (Recovery Management Support) 
1-149,1-220 

channel check handler (CCH) 1-149 
control register assignments 1-152 
machine check handler (MCH) 1-149 
system initialization 1-150 



saved systems 

finding 1-69 

verifying existence of 1-69 
saving the 3704/3705 control program image 

1-224 
scheduler 

functions, other 1-216 

I/O paging 1-206 
scheduling 1-214 

console 1-198 

interrupt handling 1-195 

I/O 1-91,1-190,1-195 

support routines 1-136 

users for execution 1-215 

virtual machines 1-128 
examples 1-130 
second-level storage 1-117 
segment, shared (see shared segment) 
segment table 1-5,1-118 

shadow 1-118 

virtual 1-118 
selector channel, virtual, I/O requests 

1-86 
shadow table 1-5,1-118 

invalidation 1-119 
shared devices., reserve/release 1-94 
shared segment 

attached processor 1-180 

storage management 1-206 
shutdown, normal 1-210 
simulation 

privileged instruction 1-3,1-25 

virtual console 1-96 
control routine 1-97 
invalid operation 1-97 
read routine 1-96 
sense operation 1-97 
TIC operation 1-97 
write routine 1-97 
single-instruction mode 1-9 
SIO (see Start I/O (SIO) instruction) 

virtual 1-84 
SMSG 

special message facility 1-41 

usage 1-42 
soft error, recovery 1-117 
space, allocation, DASD 1-139 
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special message facility, SMSG 1-40 
spool buffer, management 1-138 
spool data, format 1-137 
spool file 

attributes 1-145 
CiiScJc point 

initialization 1-224 

recovery 1-224 
closing with VM/VS Handshaking feature 

1-43 
commands 1-144 
DASD, space exhausted 1-149 
deletion of 1-219 
error recovery 1-148 
format 1-137 

management, commands 1-147 
manipulation 1-53 
real 

input processing 1-143 

output processing 1-142 
recovery 

after checkpoint start 1-8 

after force start 1-9 

after warm start 1-8 
states 1-145 
virtual 

input processing 1-141 

output processing 1-140 
spooling 1-216 
commands 

for real device 1-146 

for virtual device 1-146 
CP 1-136 

DASD errors 1-148 
described 1-7 
real 1-22 

management 1-142 
terminal input 1-9 
terminal output 1-9 
to the real input device 1-219 
to the real printer 1-218 
to the real punch 1-218 
via HSC5 1-7 
virtual 1-21 

management 1-139 
virtual console 1-141 
virtual device to real device 1-216 
start 

VH/37 

cold 1-14 

warm 1-14 
Start I/O (SIO) instruction 
handling 1-26 
operation, CP 1-195 
reducing 1-26 
virtual 1-84 
start/stop terminals, interrupt processing 
1-197 



states, spool file 1-145 
status, changes, user 1-132 
storage 

allocation 1-203 
dynamic paging 1-27 
free, management of 1-77 
protection 1-77 

size, determining for virtual machine 
1-67 
storage management 
free 1-207 
shared segment 1-206 
temporary disk 1-206 
storage protection 
fetch 1-77 
storing 1-77 
storing, storage protection 1-77 
subpool 

calling DHKFREE for 1-121 
calling DHKFBET for 1-121 
subroutines 
CCH 

channel control 1-158 
channel error analysis 1-159 
HCH 1-152 

buffer error 1-157 
initial analysis 1-153 
main storage analysis 1-154 
operator communication 1-155 
recovery facility mode switching 

1-155 
soft recording 1-156 
storage protect feature (SPP) 

analysis 1-154 
termination 1-157 
virtual user termination 1-155 
supervisor, I/O 1-83 
supervisor state, SVC interrupts, 

processing of 1-184 
support, dedicated channel 1-96 
support routines, dispatching and 

scheduling 1-136 
5YC interrupt 1—74 
handling 1-17 
problem state 1-17,1-183 
supervisor state 1-17,1-184 
SVC 76 error recording 1-161,1-222 
system 

dump of 1-210 

dump spool file, reading 1-62 
failure, recovery 1-149 
initialization 1-122,1-209 

for BBS 1-150 
start, warm 1-209 
symbol table, reading 1-63 
termination 1-123 

virtual machine, attaching to 1-211 
system support modules 1-79 
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Systei/370 

recovery 1-151 

control registers used by MCH 1-152 
ECC validity checking 1-152 
processor retry 1-151 



tape, error recovery 1-165 

temporary disk storage Management 1-206 

terminals 

disconnecting 1-126 

I/O control 

disabling 1-196 
enabling 1-196 
termination 

abnormal (see abnormal termination 
(abend)) 

CP 1-123 

procedures, CP 1-208 

system 1-123 

virtual machine 1-211 
third-level storage 1-118 
time management 1-4 
time slice 1-11 
timer 

interrupt 1-76 

interval timer 1-38 

virtual, maintenance 1-81 
timing 

facilities 
real 1-81 
virtual 1-82 
trace table entries for ECPS 1-411 
tracing, virtual 1-23 



unit check errors, DASD 1-164 
unit record 

devices, sharing 1-7 

I/O errors 1-148 
unlocking, page of free storage 1-203 
user 

directory (see Virtual Machine 
Facility/370 (¥M/370) , directory) 

dispatching states 1-130 

status changes 1-132 



vary offline, attached processor 1-73 

virtual 

address 1-24 

channel-to-channel adapter 1-86 
console functions, DIAGNOSE instruction 
1-51 



I/O interrupts 1-90 

I/O requests 1-84 

output files, closing of 1-216 

processor 1-3 

relocation 1-117 

selector channel I/O requests 1-86 

SIO 1-84 

spooling 

card reader 1-21 

printer 1-21 

punch 1-21 
tracing 1-23 
virtual=real option 1-5,1-29,1-32,1-110 
virtual address, translation 1-20 
virtual console 
operator's 1-3 
simulation 1-96,1-192 

control routine 1-97 

invalid operation 1-97 

read routine 1-96 

sense operation 1-97 

TIC operation 1-97 

write routine 1-97 
spooling 1-141 
virtual device 

defining 1-125 
detaching 1-126 
I/O 1-3 

spooling commands 1-146 
virtual interval timer assist 
1-38,1-409,1-421 
interrupt 1-422 
maintenance 1-422 
virtual machine 

attaching to the system 1-123,1-211 

creation 1-3 

description 1-3 

DIAGNOSE instruction usage 1-49 

directory 1-3 

disconnecting 1-126 

dispatching and scheduling 1-128,1-215 

dispatching lists 1-128 

dispatching scheme 1-11 

examples of 1-130 
error recording 

via SVC 76 1-161,1-222 
initialization 1-211 
input files, closing of 1-217 
input processing 1-217 
interrupt 

handling by CP 1-3 

reflection 1-192 
I/O 

instruction simulation 1-191 

management 1-6 

operation 1-26 

scheduling 1-190,1-195 
IPL of 1-211 
machine states 1-128 
operating system 1-3 
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output processing 1-216 
performance, options 1-30 
pointer list 1-411 
preferred 1-30 
PSW 1-10 

storage management 
directory 1-4 
virtual storage 1-4 
storage size, determining 1-67 
termination 1-211,1-212 
time management 

conversational user 1-4 
nonconversational user 1-4 
priority of execution 1-4 
virtual machine assist, expanded 1-409 
virtual machine assist feature 
described 1-35 
restrictions for use of 1-36 
usage 1-36 

used to reduce real supervisor state 
time 1-35 
Virtual Machine Communication Facility 

(VMCF) (see VMCF) 
Virtual Machine Facility/370 (VM/370) 
control program 1-3 
device types in 1-58 
DIAGNOSE instruction in 1-49 
directory 

description 1-3 
reading 1-63 
routines 1-223 
updating 1-63 
program states 1-10 
timing facilities 1-81 
real 1-81 
virtual 1-82 
3850 MSS support 1-423 
virtual page tables 1-118 
virtual segment tables 1-118 
virtual spooling manager (DMKVSP) 1-139 
virtual storage 1-3 

management 1-105,1-138 
CP 1-4 

EC mode 1-204 
non-EC mode 1-204 
paging, error recovery 1-116 
releasing pages 1-207 
virtual-to-real address translation 1-24 
VMCF (Virtual Machine Communication 
Facility) 1-39 

control block relationships 1-41 
control blocks and data areas 1-40 
DIAGNOSE instruction 1-69 
DIAGNOSE interface 1-39 
special external interrupt 1-40 
VM/VS Handshaking feature 1-43 
closing CP spool files 1-43 
miscellaneous enhancements 1-45 
pseudo page faults 1-43 



VM/370 (see Virtual Machine Facility/370 

(VM/370)) 
VS1 nonpaging mode 1-44 



it 

warm start 1-14,1-209 

working set, calculating 1-132 

write continue, I/O program 1-101 

write ENQ, I/O program 1-101 

write initial, I/O program 1-100 

write reset, I/O program 1-101 

write text data message, data format 1-103 

write text message for the copy command, 

data format 1-103 
writing a DASD page to virtual storage 

1-204 



2860 channel, error analysis 1-159 
2870 channel, error analysis 1-160 
2880 channel, error analysis 1-160 



3 
3270 

remote 

binary synchronous line 

enabling/disabling 1-201 
binary synchronous line error 

recovery 1-171,1-202 
CCW format 1-98 
data formats 1-103 
I/O programs for 1-99 
programming 1-97 
secondary interrupt processor 1-201 
virtual console interface 1-65 
3330V, MSS support 1-71 

-»"lrtn /line 
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interrupt handling 1-199 

saving control program image 1-65,1-224 
3800 

CHARS 1-140,1-144 

FCB 1-140,1-144 

FLASH 1-140,1-144,1-218 

loading into virtual storage 1-70 

MODIFY 1-140,1-144 

related information 1-140 

specifying invalid load module 1-148 

using CHANGE command 1-147 

using SPOOL command 1-146 
3850 (see MSS support) 
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